Markdown 语法教程:从标题到表格,一页学会
Markdown 是一种用纯文本写出“带格式文档”的方法。只要在文字前后加上几个符号,例如 #、*、-,阅读器就会把它排成标题、加粗和列表。README、技术文档、博客、笔记软件(Notion、Obsidian、语雀)都在用 Markdown,学一次就能到处用。
本教程整理了最常用的语法,每一段都附上示例。写好的 .md 文件可以直接拖进墨阅 Markdown 在线阅读器预览效果。
标题
在行首加上 #,数量代表层级,# 是最大的标题,最多到 ######。# 后面要留一个空格。
# 文档标题
## 第一章
### 1.1 小节
一份文档通常只放一个 # 大标题,其余用 ##、### 分层。墨阅会根据标题自动生成右侧目录。
段落与换行
连续的文字会被视为同一段。想开新段落,中间空一行即可。如果只想换行不分段,可以在行尾加两个空格。
加粗、斜体与删除线
**加粗文字**
*斜体文字*
~~删除线~~
`行内代码`
中文排版建议少用斜体,用 加粗 强调重点会更清楚。
列表
无序列表用 -、* 或 + 开头;有序列表用数字加句点。缩进两到四个空格可以做出嵌套列表。
- 苹果
- 香蕉
- 芭蕉(嵌套项)
1. 先打开文件
2. 再选择主题
3. 开始阅读
任务列表
GitHub 风格 Markdown(GFM)支持复选框,很适合写待办事项:
- [x] 完成大纲
- [ ] 补充示例
- [ ] 校对错字
链接与图片
[墨阅](https://md-viewer.amemori.win/)

图片语法比链接多一个感叹号。替代文字 会在图片无法显示时出现,也能帮助屏幕阅读器和搜索引擎理解图片内容。在墨阅中使用“打开文件夹”,文档引用的本地图片就能正常显示。
引用
在行首加上 >,适合放引文、提示或要点总结:
> 留白之间,自有风景。
代码块
用三个反引号包住代码,并在开头标注语言名称,就能获得语法高亮:
```javascript
const total = [1, 2, 3].reduce((a, b) => a + b, 0);
console.log(total);
```
墨阅支持上百种语言的高亮。标注为 javascript 的代码还能点击“▷ 运行”,在安全沙盒中运行并查看结果。
表格
用 | 分隔列,第二行用 --- 分隔表头。冒号可以控制对齐方式。
| 功能 | 快捷键 | 说明 |
| :--- | :---: | ---: |
| 打开文件 | Ctrl O | 选择 .md 文件 |
| 搜索正文 | Ctrl F | 查找关键词 |
:--- 左对齐、:---: 居中、---: 右对齐。更多技巧请看 Markdown 表格教程。
分割线与转义字符
三个以上的 - 或 * 会变成分割线。想显示 *、# 这类符号本身,在前面加上反斜杠 \ 即可,例如 \*不是斜体\*。
进阶:图表与数学公式
标准 Markdown 不包含图表和公式,但很多工具都支持以下两种扩展语法,墨阅也完整支持:
- Mermaid 图表:用文字画流程图、时序图、甘特图,请看 Mermaid 图表教程。
- LaTeX 数学公式:用
$...$与$$...$$写出漂亮的数学式,请看 LaTeX 数学公式教程。
Markdown 语法速查表
| 想要的效果 | 写法 |
|---|---|
| 标题 | # 标题 |
| 加粗 | **文字** |
| 斜体 | *文字* |
| 删除线 | ~~文字~~ |
| 链接 | [文字](网址) |
| 图片 |  |
| 无序列表 | - 项目 |
| 有序列表 | 1. 项目 |
| 任务列表 | - [ ] 待办 |
| 引用 | > 引文 |
| 行内代码 | `code` |
| 分割线 | --- |
写完了吗?把文件拖进墨阅,就能看到排版后的样子,也可以直接导出 PDF 分享给别人。