Markdown 语法速查表
从标题、粗体和列表，到表格、任务列表与代码块：复制最小示例，并在渲染预览中确认结果。
常用 Markdown 语法
“语法”列是源文件写法，“显示说明”描述渲染结果。基础语法最通用；GFM 扩展仍需在最终平台测试。
| 用途 | 语法 | 显示说明与注意事项 | 复制 |
|---|---|---|---|
| 标题基础语法 | | 按层级显示文档标题井号后留一个空格；不要只为了字号跳级。 | |
| 段落与换行基础语法 | | 空行分隔两个段落普通回车不一定产生新段落，最稳定的方式是留一行空白。 | |
| 粗体基础语法 | | “重点”以粗体显示文字两侧各放两个星号。 | |
| 斜体基础语法 | | “补充说明”以斜体显示中文斜体在部分字体中不明显，仍应靠文字表达语义。 | |
| 粗斜体基础语法 | | 文字同时使用粗体和斜体不要在一段中大量使用强调。 | |
| 无序列表基础语法 | | 显示三个项目符号减号后需要空格；嵌套列表要保持一致缩进。 | |
| 有序列表基础语法 | | 显示带编号的步骤编号后使用句点和空格。 | |
| 链接基础语法 | | “使用指南”成为可点击链接链接文字应说明目的，不要只写“点这里”。 | |
| 图片基础语法 | | 显示图片；加载失败时提供替代文字相对路径以 Markdown 文件或发布环境为基准，移动文件后要一起检查图片。 | |
| 引用基础语法 | | 显示一段引用块大于号后留一个空格。 | |
| 行内代码基础语法 | | 命令使用等宽代码样式适合短命令、文件名和变量，不适合多行代码。 | |
| 代码块基础语法 | | 显示带 JavaScript 语言标识的代码块开始和结束围栏各用三个反引号，并单独占一行。 | |
| 分隔线基础语法 | | 显示一条水平分隔线三个或更多减号单独占一行；在幻灯片工具中可能同时表示分页。 | |
| 转义基础语法 | | 显示带星号的普通文字在具有 Markdown 含义的符号前加反斜杠。 | |
| 表格GFM 扩展 | | 显示两列表格，第一列左对齐、第二列右对齐表头下面必须有分隔行；复杂合并单元格不属于标准 Markdown 表格。打开表格生成器 | |
| 任务列表GFM 扩展 | | 显示一项已完成和一项未完成任务`[ ]` 中间保留空格，完成项使用 `[x]`。 | |
| 删除线GFM 扩展 | | “旧方案”显示删除线这是常见 GFM 扩展，并非所有 Markdown 渲染器都支持。 | |
| 自动链接GFM 扩展 | | 部分平台自动把 URL 识别为链接为了可读性和稳定性，正文仍建议使用带描述的标准链接语法。 |
Markdown 表格怎么写
表格至少需要表头、分隔行和一行数据。竖线负责分列，分隔行中的冒号控制对齐。
| 工具 | 用途 |
| :--- | :--- |
| 编辑器 | 编写与预览 |
| 转换器 | 下载其他格式 |- 列数要一致；缺失单元格用空内容补齐。
- 单元格中的竖线写成 `\|`。
- 手机或 PDF 中避免超过四到五列的宽表。
Markdown 为什么没有正确显示
先检查空格、空行和成对标记，再确认目标平台是否支持该扩展。
标题显示成普通文字
原因：`#` 后没有空格
修复：改为 `## 安装`，不要写 `##安装`。
列表和上一段连在一起
原因：块之间缺少空行或缩进混乱
修复：在列表前后留空行，并统一嵌套缩进。
代码后面的内容都变成代码
原因：代码围栏没有闭合
修复：在代码结束后的独立一行补上三个反引号。
表格只显示竖线文字
原因：缺少表头分隔行或平台不支持 GFM
修复：补上 `| --- | --- |`，并在最终平台检查兼容性。
图片不显示
原因：路径相对于文件位置已失效，或远程地址不可访问
修复：核对文件位置、大小写、URL 权限和 HTTPS。
星号被当成格式
原因：需要显示字面符号却没有转义
修复：写成 `\*文字\*`。
CommonMark、GFM 与平台差异
- CommonMark 提供较稳定的基础语法范围。
- GitHub Flavored Markdown（GFM）增加表格、任务列表、删除线和自动链接等常见能力。
- 脚注、数学公式、流程图、标题 ID 和高亮通常属于平台扩展，使用前查目标渲染器文档。
- 本站预览用于检查常见结构，正式发布前仍应在 GitHub、文档站、公众号或目标应用中再看一次。
Markdown 语法常见问题
Markdown 和 HTML 有什么区别？
Markdown 用少量易读符号描述常见文档结构；HTML 的标签和属性更丰富，能表达网页结构和更多细节。Markdown 通常会先渲染为 HTML 再显示。
Markdown 文件一定是 .md 吗？
`.md` 最常见，`.markdown` 也能见到。文件本质是纯文本，扩展名帮助编辑器和系统识别用途。
标题前可以不用 # 吗？
部分语法支持 Setext 标题，但 ATX 写法 `# 标题` 更直观，也更适合速查和层级维护。
如何在 Markdown 中换行？
要开始新段落，留一个空行最稳定。强制软换行的规则在不同平台可能不同，不要依赖编辑器里的视觉折行。
为什么 Markdown 表格在某些应用里不显示？
表格是常见 GFM 扩展，不属于最基础语法。先检查分隔行，再确认应用是否支持表格。
Markdown 可以做合并单元格吗？
标准 Markdown 表格不支持 rowspan 或 colspan。需要复杂表格时，应简化结构或使用目标平台允许的 HTML。
图片替代文字有什么用？
图片加载失败或使用屏幕阅读器时，替代文字说明图片内容。它也能帮助迁移时识别图片用途。
可以把 Markdown 语法全部背下来吗？
没有必要。先掌握标题、强调、列表、链接和代码；表格、转义等低频语法需要时查速查表即可。