判断一份 Markdown 文档是否合格,可以看两条:在纯文本状态下是否易读;渲染后是否层次清楚、不产生歧义。日常写作优先使用 CommonMark 核心语法;需要表格、任务列表、删除线时,再使用 GitHub Flavored Markdown(GFM)扩展。以下按使用频率组织。 标题与段落 标题用 `#` 至 `######`,一级标题通常一个文档只出现一次。不要跳级:如果上一级是 `##`,
要判断一份 Markdown 文档是否合格,核心标准是:结构可扫读、语法可渲染、维护成本低。满足这三条,通常就能作为可靠的技术文档、项目说明或知识库内容长期使用。 适用场景与边界 Markdown 最适合以标题、列表、代码块、表格和链接为主的文本内容,例如 README、接口说明、操作手册、个人笔记和静态站点源文件。判断标准:如果内容主要靠文字结构和少量标记表达,选择 Markdown 成本最低;