判断 Markdown 写作是否合格，优先看它在不渲染时是否仍然层次清楚、重点明确。渲染不是补救手段，纯文本可读性本身就是语法的一部分。Markdown 最适合技术文档、说明、笔记、评论和静态页面正文，不适合需要精确分页、复杂图文混排或法定公文格式的场景。写作时遵守两条底线：不要用连续空格或 Tab 模拟缩进；段落之间用空行分隔，不要依赖单次换行。以下按常用元素给出判断标准与写法建议。 一、标题与

判断一个文档是否适合用 Markdown，先看两个条件：内容是否以结构化文字为主，是否需要长期纯文本维护和版本对比。只要满足这两点，Markdown 通常比可视化排版更稳定；如果涉及严格分页、精确印刷或复杂批注，则应改用专用排版工具。 标题与段落 标题用 `#` 表示，数量对应级别：`#` 一级、`##` 二级、`###` 三级。一个文档通常只保留一个一级标题，正文分节从二级标题开始，层级不要跳跃

判断 Markdown 语法是否“能用”，先确认目标平台遵循 CommonMark 还是 GitHub Flavored Markdown（GFM）。日常写作优先掌握五类语法：块级结构、行内强调、列表与任务、链接图片、代码表格。其余扩展语法只应在平台支持时使用，否则宁可改写为普通段落或表格。 一、块级语法：先搭骨架，再填内容 块级语法决定文章结构和可扫读性。最常用的是标题、段落、引用、分隔线。标题

判断标准：一份 Markdown 是否可维护，取决于是否区分 CommonMark 基础语法与 GFM 扩展语法。日常写作建议以 CommonMark 为底线，只有在 GitHub、GitLab、Notion 等明确支持 GFM 的环境，才使用表格、任务列表、删除线等扩展。 一、标题与段落 标题用 `#` 到 `######`。一篇文档通常只保留一个一级标题，正文内从二级标题开始，不要跳级。段落间

判断 Markdown 是否适合当前文档，可以看三个条件：内容是否以文本为主、是否需要长期可读、是否会被多人编辑或版本管理。只要满足其中两项，使用 Markdown 通常比二进制格式和排版工具更稳。Markdown 的价值不在视觉装饰，而在结构稳定、可转换、可 diff。 一、先确定方言：CommonMark 还是 GFM 写作前先明确渲染环境。GitHub、GitLab、多数代码托管平台和 VS

判断一份 Markdown 文档是否合格，可以看两条：在纯文本状态下是否易读；渲染后是否层次清楚、不产生歧义。日常写作优先使用 CommonMark 核心语法；需要表格、任务列表、删除线时，再使用 GitHub Flavored Markdown（GFM）扩展。以下按使用频率组织。 标题与段落 标题用 `#` 至 `######`，一级标题通常一个文档只出现一次。不要跳级：如果上一级是 `##`，

Markdown 是否值得用，判断标准很简单：如果内容以文字、列表、代码、链接为主，就用 Markdown；如果需要复杂分栏、精确打印版式、公文红头，应换用排版工具。新手先掌握标题、列表、链接、代码、表格五类语法，就能覆盖大多数笔记和文档场景。 ## 适用场景与工具选择 - 适合：笔记、README、项目说明、技术博客、论坛发帖、API 文档。 - 不适合：正式公文、复杂海报、需要严格分页或页眉页

判断 Markdown 用法是否合格，核心标准是：标记最少、层次清楚、渲染稳定、可读性强。先掌握 CommonMark 基础，再按发布平台选择 GFM 扩展，可以避免大部分兼容问题。 一、标题与段落 标题用 `#` 到 `######` 表示，一级标题通常全篇只用一个，正文分节从二级标题开始。不要跳级，例如不要从 `##` 直接到 `####`。写完标题后空一行再写正文，同一节只讨论一个主题。 段

判断一份 Markdown 文档排版是否合格，通常看三个条件：渲染后目录层级连续、列表与代码块缩进一致、平台特有语法不干扰阅读。排版的目标不是装饰，而是让读者能快速扫读，让渲染器稳定输出。 ## 标题与段落 标题用于划分文档骨架，不用于放大字号。二级标题是主要分节，三级及以下逐级展开；不要从二级直接跳到四级。先列二级标题形成大纲，再在每节内填段落。普通段落之间空一行，不要用连续空格或 Tab 模拟

判断 Markdown 是否适合当前任务，主要看两点：内容是否以文字为主，以及是否需要长期维护、版本管理或多平台发布。如果答案都是“是”，Markdown 通常比二进制文档更可靠。它不擅长复杂分页、精确版式和多栏排版，这类需求应选择排版工具或办公套件。 适用场景与工具选择 适用场景包括：仓库说明文档、技术笔记、博客草稿、论坛回复、内部知识库、API 文档等。判断标准建议：内容需要频繁修改、多人协作