markdown用法

判断一篇 Markdown 是否合格，先看它在纯文本状态下是否仍能清晰表达结构：标题、段落、列表、代码、链接和表格不依赖排版软件即可辨认。掌握以下用法，可以覆盖大多数文档写作与发布场景。

标题与段落：结构先于样式

标题用 `#` 到 `######` 表示层级，一个文档通常只保留一个一级标题，二级标题作为主要分节。写法要求在 `#` 后加一个空格，例如 `## 标题与段落`。不要跳级使用标题，避免一级标题后直接出现三级标题。 段落之间用空行分隔，不要用连续空格或 Tab 模拟首行缩进。强调优先使用粗体 `重点`；斜体只用于书名、术语或轻微区分。判断标准是：去掉渲染后，纯文本的层级和分段仍然清楚，即为合格。

列表与引用：步骤、清单和提示

无序列表统一用 `-`，有序列表用 `1.`、`2.`。同一篇文档不要混用 `*`、`+`、`-`，否则不同编辑器可能显示不一致。嵌套列表缩进 2 到 4 个空格，前后留空行，避免被合并到上一段。 引用用 `>`，可以嵌套，适合放摘录、提示或风险说明。例如： > 提示：发布前需要人工复核链接和图片。 任务列表 `- [ ] 待办`、`- [x] 完成` 属于 GFM 扩展，并非所有平台都支持；正式文档不应将其作为唯一的状态记录方式。

代码与链接：技术文档的高频组合

行内代码用反引号包裹，例如 `print("hello")`。代码块使用三个反引号并标注语言，例如： python print("hello") 链接写作 `[文字](地址 "标题")`，地址应使用完整 URL；图片写作 ``，替代文字必须能描述图片内容，不能只写“图片”。当需要显示 ``、`#`、`[` 等符号本身时，用反斜杠转义，例如 `\`。

表格与任务列表：按平台能力选用

GFM 表格使用竖线和连字符，分隔行写为 `| --- | :---: |`，分别控制左对齐、居中和右对齐。单元格内出现竖线必须写作 `\|`，否则会破坏列结构。表格列数必须保持一致，分隔行至少使用三个连字符。 以下是一个最小示例： | 语法 | 写法 | 适用场景 | | --- | :---: | --- | | 无序列表 | `- 项目` | 并列要点 | | 有序列表 | `1. 步骤` | 顺序步骤 | | 任务列表 | `- [ ] 待办` | 检查清单 | 任务列表适合项目进度或检查清单，但要确认阅读平台支持 GFM。若面向通用 Markdown 环境，建议改用普通无序列表加文字说明。

转义与发布前检查：避免渲染错误

发布前至少检查六项：标题层级是否跳级；链接能否打开；图片是否显示；代码块语言标注是否正确；表格列数是否一致；列表缩进是否错乱。先在任何纯文本编辑器中写作，再放到目标平台预览。 需要显示 Markdown 语法符号本身时，使用反斜杠转义，如 `\#`、`\_`、`\[`。不要用 HTML 标签代替 Markdown 结构，除非目标平台明确要求。 Markdown 的价值在于用最少的语法表达清晰结构，而不是堆叠样式。初学阶段先掌握标题、段落、列表、代码、链接五类基础语法，再根据平台能力使用表格和任务列表。最终判断标准是：换一个平台打开，结构不丢、易读性不降，就是合格的 Markdown。