Markdown 速查:我写博客常用的十几条

320 字 2 分钟

Markdown 速查:我写博客常用的十几条

语法不用背全,常用的就这些。写的时候顺手,比记规则重要。

基础#

# 一级标题(每篇只用一个)
## 二级标题
### 三级标题
普通段落直接写,段落之间空一行。
**加粗** *斜体* ~~删除线~~ `行内代码`
[链接文字](https://example.com)
![图片说明](/images/photo.jpg)

列表#

- 无序列表
- 第二项
- 缩进两个空格表示子项
1. 有序列表
2. 第二项

引用与分割线#

> 这是一段引用。
> 可以写多行。
---

代码块#

带语言名会有语法高亮:

```bash
sudo systemctl restart nginx
```

表格#

| 字段 | 说明 |
|---|---|
| title | 文章标题 |
| date | 日期,格式 2026-10-19 |
| tags | 数组,如 [折腾, 记录] |

文章开头的 frontmatter#

这个站的文章必须带这几行:

---
title: 文章标题
description: 一句话摘要,会出现在列表和搜索引擎里
published: 2026-10-19
tags: [折腾, 记录]
draft: false
---

draft: true 的文章不会出现在站点上,适合写一半先存着。

几个习惯#

  1. 标题只用一个 #,其余用 ## 往下排,结构清晰
  2. 每段别超过四五行,手机上看太长会累
  3. 代码块标语言,不然没高亮
  4. 图片先压,1MB 以上的图放上去,首屏就废了

就这些。剩下的用到再查。

余笙

2026-10-19 · 余笙听闻

文章目录

WELCOME欢迎来到余笙听闻

很高兴在这里遇见你。