判断一份 Markdown 文档排版是否合格,通常看三个条件:渲染后目录层级连续、列表与代码块缩进一致、平台特有语法不干扰阅读。排版的目标不是装饰,而是让读者能快速扫读,让渲染器稳定输出。 ## 标题与段落 标题用于划分文档骨架,不用于放大字号。二级标题是主要分节,三级及以下逐级展开;不要从二级直接跳到四级。先列二级标题形成大纲,再在每节内填段落。普通段落之间空一行,不要用连续空格或 Tab 模拟
Markdown 的定位不是“排版工具”,而是用纯文本表达结构的书写约定。是否选用,只有一个判断标准:如果你的内容以标题、段落、列表、代码、链接、图片为主,并且需要长期保存、跨软件编辑或版本管理,就适合用 Markdown;如果需要精确分页、多栏、复杂图文混排或法定公文格式,应直接选用 Word、LaTeX 或专业排版软件。 一、什么时候该用 Markdown 适用场景包括:项目说明 README
Markdown 的价值不在“排版”,而在于用少量符号把结构写进纯文本,保证源码可读、渲染可预期。判断一段 Markdown 是否合格,核心标准只有两条:源码不依赖编辑器,渲染结果与语义一致;目标平台支持所用扩展语法。以下按常用语法分组说明写法、适用场景与注意事项。 标题与段落 标题一律使用井号加空格,`#` 数量对应级别,最多到 `######`。写作时不要跳级:一级标题通常留给文档标题或站点页
Markdown 的核心不是“排版”,而是用少量符号给纯文本加结构。判断是否学会,标准只有一个:别人拿到你的 `.md` 文件,不依赖你的编辑器,也能看懂层级、链接和代码。先掌握标题、列表、链接、代码块四类语法,就能覆盖大多数笔记、README 和技术文档。 ## 先认准基准:CommonMark 与 GFM Markdown 有多个方言,新手最容易卡在“我这里能渲染,你那里不行”。比较稳妥的选择