Markdown 语法教程:从标题到表格,一页学会

Markdown 是一种用纯文本写出“带格式文档”的方法。只要在文字前后加上几个符号,例如 #、*、-,阅读器就会把它排成标题、加粗和列表。README、技术文档、博客、笔记软件(Notion、Obsidian、语雀)都在用 Markdown,学一次就能到处用。

本教程整理了最常用的语法,每一段都附上示例。写好的 .md 文件可以直接拖进墨阅 Markdown 在线阅读器预览效果。

标题

在行首加上 #,数量代表层级,# 是最大的标题,最多到 ######。# 后面要留一个空格。

# 文档标题
## 第一章
### 1.1 小节

一份文档通常只放一个 # 大标题,其余用 ##、### 分层。墨阅会根据标题自动生成右侧目录。

段落与换行

连续的文字会被视为同一段。想开新段落,中间空一行即可。如果只想换行不分段,可以在行尾加两个空格。

加粗、斜体与删除线

**加粗文字**
*斜体文字*
~~删除线~~
`行内代码`

中文排版建议少用斜体,用 加粗 强调重点会更清楚。

列表

无序列表用 -、* 或 + 开头;有序列表用数字加句点。缩进两到四个空格可以做出嵌套列表。

- 苹果
- 香蕉
  - 芭蕉(嵌套项)

1. 先打开文件
2. 再选择主题
3. 开始阅读

任务列表

GitHub 风格 Markdown(GFM)支持复选框,很适合写待办事项:

- [x] 完成大纲
- [ ] 补充示例
- [ ] 校对错字

链接与图片

[墨阅](https://md-viewer.amemori.win/)
![替代文字](images/photo.png)

图片语法比链接多一个感叹号。替代文字 会在图片无法显示时出现,也能帮助屏幕阅读器和搜索引擎理解图片内容。在墨阅中使用“打开文件夹”,文档引用的本地图片就能正常显示。

引用

在行首加上 >,适合放引文、提示或要点总结:

> 留白之间,自有风景。

代码块

用三个反引号包住代码,并在开头标注语言名称,就能获得语法高亮:

```javascript
const total = [1, 2, 3].reduce((a, b) => a + b, 0);
console.log(total);
```

墨阅支持上百种语言的高亮。标注为 javascript 的代码还能点击“▷ 运行”,在安全沙盒中运行并查看结果。

表格

用 | 分隔列,第二行用 --- 分隔表头。冒号可以控制对齐方式。

| 功能 | 快捷键 | 说明 |
| :--- | :---: | ---: |
| 打开文件 | Ctrl O | 选择 .md 文件 |
| 搜索正文 | Ctrl F | 查找关键词 |

:--- 左对齐、:---: 居中、---: 右对齐。更多技巧请看 Markdown 表格教程。

分割线与转义字符

三个以上的 - 或 * 会变成分割线。想显示 *、# 这类符号本身,在前面加上反斜杠 \ 即可,例如 \*不是斜体\*。

进阶:图表与数学公式

标准 Markdown 不包含图表和公式,但很多工具都支持以下两种扩展语法,墨阅也完整支持:

Markdown 语法速查表

想要的效果 写法
标题 # 标题
加粗 **文字**
斜体 *文字*
删除线 ~~文字~~
链接 [文字](网址)
图片 ![说明](路径)
无序列表 - 项目
有序列表 1. 项目
任务列表 - [ ] 待办
引用 > 引文
行内代码 `code`
分割线 ---

写完了吗?把文件拖进墨阅,就能看到排版后的样子,也可以直接导出 PDF 分享给别人。