场景解决方案2026年8月9日

Markdown 语法怎么写?10 个高频写法边学边练

第一次写 Markdown,记不住那些 # * ` 符号?本文只讲最常用的十个高频语法:标题、加粗斜体、列表、任务清单、链接图片、代码块、引用、表格、分割线,每个都给源码 + 渲染效果对照,并附可直接复制到在线编辑器练习的例子。

刚接触 Markdown 的人常被 #*、反引号劝退,其实日常写作真正高频的语法只有十个左右。把这十个练熟,就能写博客、README、笔记、周报。本文每个语法都给「源码 + 渲染效果」对照,并附上可直接复制到编辑器里动手改的例子。

Markdown 高频语法:源码与渲染效果对照

Markdown 是什么?为什么值得学?

Markdown 是一套用普通符号给纯文本「标记排版」的轻量语法:你用 # 标记标题、* 标记重点、- 标记列表,渲染器再把这些符号变成真正的排版。它的价值在于内容与格式分离——源码本身就清晰可读,同一份 .md 还能一键转成 HTML、Word、PDF,或发到公众号、小红书。

正因如此,GitHub、各类笔记软件、静态博客、AI 对话框几乎都把 Markdown 当默认书写格式。学习成本极低:不需要鼠标在工具栏里点来点去,双手不离键盘就能排版。下面从最高频的十个语法讲起,看完就能上手。

标题怎么写?用几个 # 决定层级

标题用行首的 # 表示,几个 # 就是几级标题,# 与文字之间必须留一个空格。一级标题通常作为全文大标题,正文里的小节多用二级(##)、三级(###)。

边学边练: 打开 Markdown 在线编辑器,把下面的示例复制到左侧,再对照右侧实时预览改一改 # 的数量;后面每节语法都可以用同样方式动手练。

markdown# 一级标题(全文大标题)
## 二级标题(章节)
### 三级标题(小节)
#### 四级标题

渲染效果如下(截自在线编辑器预览):

标题层级的渲染效果

新手最常见的坑就是把 #标题 写在一起——少了空格,多数渲染器不会识别成标题,而是原样显示。层级也不要跳级(从 # 直接跳到 ###),保持规整对后续转 Word/PDF 生成目录很重要。

怎么加粗、倾斜、加删除线?

强调类语法用成对符号把文字包起来:加粗用两个星号 **文字**斜体用一个星号 *文字*删除线用两个波浪号 ~~文字~~,三者还能叠加。

markdown这句话里有 **加粗***斜体****加粗又斜体***,还有 ~~划掉的旧价格~~

加粗、斜体、删除线的渲染效果

一个细节:中文和符号之间不需要空格,但如果加粗内容紧贴中文有时不生效,可以在 ** 两侧各留一个空格更保险。删除线特别适合写「原价 99 现价 39」这类对比。

无序、有序、任务清单怎么打?

列表分三种:无序列表用 - (或 * )开头,有序列表用 1. 开头,任务清单用 - [ ] (未完成)和 - [x] (已完成)。符号后面都要跟一个空格,缩进两个或四个空格可以形成子列表。

markdown无序列表:
- 苹果
- 香蕉
  - 子项也能嵌套

有序列表:
1. 打开编辑器
2. 粘贴内容
3. 导出文件

任务清单:
- [x] 已完成的事
- [ ] 还没做的事

无序、有序列表与任务清单的渲染效果

有序列表的数字其实可以全写 1.,渲染时会自动递增编号,方便中途插入条目。任务清单是 GitHub 风格 Markdown(GFM)的扩展,非常适合写 TODO、检查清单。

怎么插入链接和图片?

链接的写法是 [显示文字](网址),图片只是在前面多一个感叹号:![替代文字](图片地址)。两者结构几乎一样,区别就是图片会把内容渲染出来,而链接是可点击的文字。

markdown这是一个 [指向 MeTool 的链接](https://metool.online/)。

这是一张图片:
![MeTool 标志](https://metool.online/images/logo-removebg.png)

链接与图片的渲染效果

图片的「替代文字」在图片加载失败或被朗读时显示,建议认真写。图片地址可以是网址,也可以是本地路径;在线编辑器里还支持直接把图片拖进去或粘贴,自动生成图片语法。

行内代码和代码块怎么写(带高亮)?

短的代码或命令用一对反引号包住变成 行内代码;多行代码用三个反引号 ``` 包起来成为代码块,并在开头反引号后写上语言名(如 jspython),就能得到语法高亮。

markdown安装依赖请运行 `npm install`

```js
function hello() {
  console.log('Hello Markdown')
}
```

行内代码与带高亮代码块的渲染效果

反引号(`)在键盘左上角、数字 1 左边,注意别和单引号混淆。写技术笔记、README 时这是最常用的语法之一,标好语言名高亮才会生效。

引用块怎么写?

引用用行首的 > 表示,常用来标注重点结论、引用他人观点或做提示框。多段引用每行都加 >,还能在 > 后再嵌套 > 形成多层引用。

markdown> 这是一段引用,适合放重点结论。
>
> 引用里也能写 **加粗**`代码`

引用块的渲染效果

引用块在各平台的样式不同,但语义一致:把这段文字「降一级」标为旁注或摘录。文章开头用一句话引用做全文结论,是很常见的写法。

表格怎么画?

表格用竖线 | 分隔单元格,第二行用 --- 作为表头和内容的分隔线,在 --- 两侧加冒号可以控制对齐::--- 左对齐、:---: 居中、---: 右对齐。

markdown| 功能 | 是否常用 | 说明 |
| :--- | :---: | ---: |
| 标题 | 是 | 用 # 表示 |
| 表格 | 是 | 用竖线分隔 |

表格的渲染效果

手写表格对齐符号很累,实用做法是先在编辑器里用工具栏一键插入表格骨架,再填内容;或者把已有的 Excel/网页表格复制进支持粘贴转换的编辑器。

分割线和换行怎么处理?

分割线用单独一行的三个及以上连字符 ---(或 ***)表示,用来分隔大段落。换行则有个常见坑:Markdown 里回车一次不会换行,需要在行尾敲两个空格,或者直接空一行另起一段。

markdown第一段。

第二段(中间空了一行)。

---

分割线下面的新内容。

分割线要和上文空一行,否则 --- 紧贴文字会被误认成「上一行是标题」。段落之间统一用空行分隔,是最不容易出错的排版习惯。

十个高频语法速查表

把上面的内容浓缩成一张表,写作时忘了就扫一眼:

语法 写法 效果
标题 # 标题 分级标题
加粗 **文字** 粗体
斜体 *文字* 斜体
删除线 ~~文字~~ 划掉
无序列表 - 项目 圆点列表
有序列表 1. 项目 数字列表
任务清单 - [ ] 事项 可勾选框
链接 [文字](网址) 可点击链接
图片 ![描述](地址) 显示图片
行内代码 `代码` 等宽标注
代码块 ```语言 高亮代码
引用 > 文字 旁注
表格 | 单元 | 表格
分割线 --- 横线

边学边练:把例子贴进编辑器改一改

看懂不等于会写,最快的掌握方式是动手改。把上面任意一个例子复制到一个左边源码、右边实时预览的编辑器里,改一个符号,立刻就能看到渲染结果怎么变——比对着文档死记高效得多。

推荐用 Markdown 在线编辑器 练习:它左边写、右边即时预览,草稿自动存在浏览器本地、内容不上传,还支持导入 .md 文件、粘贴图片。练熟之后,同一份稿子可以用 Markdown 转换工具 导成 Word / PDF,或用 Markdown 在线分享 生成预览链接发给别人。更多相关工具都在 Markdown 工具箱

小结

Markdown 的高频语法就这十来个:# 标题、** 加粗、* 斜体、-/1. 列表、- [ ] 任务清单、[]() 链接、![]() 图片、` 代码、> 引用、| 表格、--- 分割线。记住两条铁律——符号和文字之间留空格、段落之间空一行——就能避开绝大多数新手坑。剩下的,打开在线编辑器边写边看,一个下午就能上手。

想继续学公式、流程图、折叠区块、上下标等进阶写法,请阅读 Markdown 进阶语法教学

本文用到的工具

常见问题

不用。日常写作真正高频的只有十个左右:标题、加粗/斜体、无序/有序列表、任务清单、链接、图片、行内代码与代码块、引用、表格、分割线。把这十个练熟,就能覆盖 90% 的写作场景,其余进阶语法用到时再查。