判断 Markdown 用法是否合格,核心标准是:标记最少、层次清楚、渲染稳定、可读性强。先掌握 CommonMark 基础,再按发布平台选择 GFM 扩展,可以避免大部分兼容问题。 一、标题与段落 标题用 `#` 到 `######` 表示,一级标题通常全篇只用一个,正文分节从二级标题开始。不要跳级,例如不要从 `##` 直接到 `####`。写完标题后空一行再写正文,同一节只讨论一个主题。 段
要判断一份 Markdown 文档是否合格,核心标准是:结构可扫读、语法可渲染、维护成本低。满足这三条,通常就能作为可靠的技术文档、项目说明或知识库内容长期使用。 适用场景与边界 Markdown 最适合以标题、列表、代码块、表格和链接为主的文本内容,例如 README、接口说明、操作手册、个人笔记和静态站点源文件。判断标准:如果内容主要靠文字结构和少量标记表达,选择 Markdown 成本最低;