markdown语法快速入门

如果目标是快速写 README、笔记、博客草稿，Markdown 的核心语法只需掌握十来个符号；先学标题、段落、列表、链接、代码和引用，就能覆盖大多数场景。判断是否入门，不看能否背全语法，而看能否在目标平台稳定预览，并清楚哪些写法只是扩展、并非处处支持。

先确认平台支持范围

Markdown 没有唯一标准。核心语法在 CommonMark 中较一致，GitHub、GitLab 常用 GFM，并增加表格、任务列表、删除线、自动链接等扩展。判断标准很简单：先看你写作的环境，是 GitHub README、静态博客、Obsidian，还是飞书、钉钉文档，支持范围并不相同。建议先用核心语法，扩展语法只在确认支持后使用。遇到不确定的写法，粘贴到目标编辑器预览，或查其帮助页。不要依赖复杂嵌套和 HTML，跨平台时最容易出问题。

标题与段落：先搭骨架

标题用行首 `#` 加空格，`#` 一级，`##` 二级，最多 `######`。通常一篇文章只用一个一级标题；若后台已保存标题，正文可从二级开始。段落之间空一行，连续文字会被合并为一段。不要在段首用空格或 Tab 缩进，容易被识别成代码块。需要换行但不分段时，可在行尾留两个空格，但更稳妥的是空行分段。写 README 时，可用二级标题划分“安装”“用法”“示例”。

强调、列表与引用：让信息可扫读

强调用 `斜体` 或 `加粗`，也可用 `_`，但中文环境推荐 ``。列表符号后要有空格：无序用 `-`、``、`+`；有序用 `1.`、`2.`。嵌套列表缩进 2 或 4 个空格，同级保持一致。引用用 `>` 加空格；多段引用每行都写 `>`。列表和引用前后留空行，能减少不同渲染器的差异。列表项较长时，可在项内分段，但续行要缩进对齐。

链接、图片与代码：技术写作高频

链接格式为 `[显示文字](https://example.com)`，可加标题：`[文字](url "说明")`。图片格式为 ``，替代文字要写，加载失败或读屏时会用到。行内代码用反引号包裹，例如 `` `npm install` ``。代码块用三个反引号包围，并在开头标注语言，如 `python`，结束再用三个反引号，可获得语法高亮。注意链接地址含空格时用 `<...>` 包裹或做 URL 编码；本地图片与图床路径要区分。

表格、任务列表与转义：按需使用

表格用 `|` 分列，第二行用 `---` 定义表头，例如 `| 名称 | 说明 |`。对齐可用 `:---`、`---:`、`:---:`。单元格内出现 `|` 时写成 `\|`。任务列表写 `- [ ] 未完成` 和 `- [x] 已完成`，常见于 GFM，不是所有平台都支持。删除线写 `~~文本~~`。转义特殊符号用反斜杠，如 `\*`、`\_`、`\#`、`\[`。分隔线单独一行写 `---` 或 `***`，前后留空行，避免被误判为标题下划线。

常见坑与练习路径

最常见的错误是空行和缩进：标题、列表、代码块、表格前后尽量留空行；不要把整段文字缩进。平台差异也要重视：脚注、公式、目录、流程图等多为扩展，上线前在目标环境预览。练习时，用 Markdown 写一份 README，包含项目说明、安装、用法、示例和许可证；再写一篇学习笔记，至少用到标题、列表、引用、链接、行内代码和代码块。遇到渲染异常，依次检查空行、缩进、特殊符号和平台支持。 掌握以上核心语法后，大多数文档场景已经够用。把可读性放在首位，保持空行和缩进一致；扩展语法按平台选用，不确定就预览。协作时最好约定方言和格式检查工具，减少渲染差异。