判断 Markdown 写作是否合格,优先看它在不渲染时是否仍然层次清楚、重点明确。渲染不是补救手段,纯文本可读性本身就是语法的一部分。Markdown 最适合技术文档、说明、笔记、评论和静态页面正文,不适合需要精确分页、复杂图文混排或法定公文格式的场景。写作时遵守两条底线:不要用连续空格或 Tab 模拟缩进;段落之间用空行分隔,不要依赖单次换行。以下按常用元素给出判断标准与写法建议。 一、标题与
判断一份 Markdown 文档是否合格,可以看两条:在纯文本状态下是否易读;渲染后是否层次清楚、不产生歧义。日常写作优先使用 CommonMark 核心语法;需要表格、任务列表、删除线时,再使用 GitHub Flavored Markdown(GFM)扩展。以下按使用频率组织。 标题与段落 标题用 `#` 至 `######`,一级标题通常一个文档只出现一次。不要跳级:如果上一级是 `##`,
判断 Markdown 用法是否合格,核心标准是:标记最少、层次清楚、渲染稳定、可读性强。先掌握 CommonMark 基础,再按发布平台选择 GFM 扩展,可以避免大部分兼容问题。 一、标题与段落 标题用 `#` 到 `######` 表示,一级标题通常全篇只用一个,正文分节从二级标题开始。不要跳级,例如不要从 `##` 直接到 `####`。写完标题后空一行再写正文,同一节只讨论一个主题。 段