Markdown 语法速查表
Markdown 的语法不多,但总有那么几个记不住:表格怎么对齐、代码块怎么高亮、任务列表的方括号里写什么。本页把常用语法与 GitHub 扩展语法分别列成对照表,随查随用。
常用语法
| 效果 | 写法 | 说明 |
|---|---|---|
| 标题 | # H1 … ###### H6 | 六级标题,# 后需空格 |
| 粗体 | **粗体** | 加粗文字 |
| 斜体 | *斜体* | 倾斜文字 |
| 粗斜体 | ***两者*** | 同时加粗倾斜 |
| 删除线 | ~~删除线~~ | 划掉的文字 |
| 无序列表 | - 项目 | 圆点列表,可嵌套缩进 |
| 有序列表 | 1. 项目 | 自动编号列表 |
| 引用 | > 引用 | 左侧竖线的引用块 |
| 行内代码 | `code` | 等宽字体的代码片段 |
| 代码块 | ```语言 | 带语言标注的高亮块 |
| 链接 | [文字](url) | 可点击的超链接 |
| 图片 |  | 嵌入图片 |
| 分割线 | --- | 一条水平分隔线 |
GitHub 扩展语法
| 语法 | 写法 | 说明 |
|---|---|---|
| 表格 | | 列 A | 列 B | | --- | --- | | 1 | 2 | | 分隔行决定对齐,见下方说明 |
| 任务列表 | - [x] 已完成 - [ ] 未完成 | 方括号内加 x 表示勾选 |
| 自动链接 | https://example.com | 裸 URL 自动识别为链接 |
| 表格左对齐 | | :--- | | 分隔行左侧加冒号 |
| 表格居中 | | :---: | | 分隔行两侧都加冒号 |
| 表格右对齐 | | ---: | | 分隔行右侧加冒号 |
常见问题
Markdown 和富文本编辑器有什么区别?
核心区别是可读性与控制权。Markdown 是纯文本加轻量标记,即使不渲染也能直接读懂,可以用任何编辑器打开,天然适合版本控制——Git 能清晰地显示每一次改动的差异,而富文本的二进制或复杂格式几乎无法做代码审查。代价是排版自由度低,复杂的图文混排做不了。反过来富文本所见即所得,排版能力强,但内容与样式耦合,迁移和协作成本高。技术文档、README、博客草稿适合 Markdown;营销页、复杂排版的海报适合富文本。
Markdown 表格怎么设置列对齐?
靠表头下面那一行分隔线控制。分隔线默认左对齐;在左边加冒号写作 :--- 是左对齐;两边都加冒号 :---: 是居中;右边加冒号 ---: 是右对齐。冒号的位置直接对应列的对齐方向,这是最直观的记法。要注意的是,分隔行里至少要有一个连字符,多写几个也无所谓,但整行的列数必须与表头一致,否则表格不会被识别。
代码块怎么写才能高亮?
用三个反引号包裹,并在开头的反引号后面紧跟语言标识符,比如 ```python 或 ```javascript。这个标识符告诉渲染器用哪种语法规则上色,写错或漏写就只会渲染成普通的等宽文本块。如果代码里本身含有反引号,可以用更多个反引号包裹来解决,比如用四个反引号包住含三个反引号的内容。只写单个词或短表达式时用一对单反号做行内代码即可。
Markdown 能直接导出成 PDF 或 Word 吗?
Markdown 本身只是文本格式,没有导出能力,需要借助工具链。最常见的是先转成 HTML 再打印或转 PDF,静态站点生成器、编辑器插件和命令行工具都能完成这一步;转 Word 一般也要先转 HTML 或 DOCX 中间格式。实际差别主要在样式上:默认转换出来的 PDF 样式朴素,想要好看需要自定义 CSS。如果最终交付物必须是排版精美的 PDF,直接用排版工具可能比走 Markdown 更省事。