Markdown 的价值不在“排版”，而在于用少量符号把结构写进纯文本，保证源码可读、渲染可预期。判断一段 Markdown 是否合格，核心标准只有两条：源码不依赖编辑器，渲染结果与语义一致；目标平台支持所用扩展语法。以下按常用语法分组说明写法、适用场景与注意事项。 标题与段落 标题一律使用井号加空格，`#` 数量对应级别，最多到 `######`。写作时不要跳级：一级标题通常留给文档标题或站点页

判断内容是否适合 Markdown，关键看三点：是否需要稳定结构、是否要在纯文本与渲染结果之间切换、是否要进入版本控制或跨工具流转。多数答案为“是”，Markdown 通常合适；若要求精确分页、复杂表格、印刷级排版，它更适合作为写作源稿，而不是最终格式。 技术文档与代码仓库 README、CHANGELOG、API 说明、Issue 与 PR 模板，是 Markdown 最成熟的场景。执行时注意：

Markdown 的价值在于把“内容结构”写成纯文本，同时能被稳定渲染。判断一份 Markdown 是否合格，看三点：源文件不渲染也能读；标题、列表、代码块层级清楚；在目标平台（GitHub、Typora、语雀、博客系统等）预览无错位。学习顺序建议先掌握 CommonMark 核心语法，再按平台补充表格、任务列表、脚注等扩展。 标题与段落：先建立结构 标题用 `#` 到 `######`，分别对应

Markdown 语法是一套用普通文本符号表达文档结构的轻量标记规则。你写的仍是 `.md` 纯文本，渲染器再把 `#`、`*`、`>` 等符号转换成标题、列表、引用、链接和代码块。判断自己是否理解它，标准很简单：能否在不用鼠标排版的情况下，写出层级清楚、链接可点、代码可读、可被不同工具稳定解析的文档，并知道不同渲染器对同一符号可能有不同解释。 它解决什么问题 Markdown 的核心价值是

Markdown 的核心不是“排版”，而是用少量符号给纯文本加结构。判断是否学会，标准只有一个：别人拿到你的 `.md` 文件，不依赖你的编辑器，也能看懂层级、链接和代码。先掌握标题、列表、链接、代码块四类语法，就能覆盖大多数笔记、README 和技术文档。 ## 先认准基准：CommonMark 与 GFM Markdown 有多个方言，新手最容易卡在“我这里能渲染，你那里不行”。比较稳妥的选择