Markdown 是否值得用，判断标准很简单：如果内容以文字、列表、代码、链接为主，就用 Markdown；如果需要复杂分栏、精确打印版式、公文红头，应换用排版工具。新手先掌握标题、列表、链接、代码、表格五类语法，就能覆盖大多数笔记和文档场景。 ## 适用场景与工具选择 - 适合：笔记、README、项目说明、技术博客、论坛发帖、API 文档。 - 不适合：正式公文、复杂海报、需要严格分页或页眉页
判断一份 Markdown 文档排版是否合格，通常看三个条件：渲染后目录层级连续、列表与代码块缩进一致、平台特有语法不干扰阅读。排版的目标不是装饰，而是让读者能快速扫读，让渲染器稳定输出。 ## 标题与段落 标题用于划分文档骨架，不用于放大字号。二级标题是主要分节，三级及以下逐级展开；不要从二级直接跳到四级。先列二级标题形成大纲，再在每节内填段落。普通段落之间空一行，不要用连续空格或 Tab 模拟
判断 Markdown 代码块是否规范，主要看三点：是否使用围栏包裹、是否明确标注语言、围栏数量与缩进是否一致。日常写作优先使用围栏代码块；缩进代码块只在兼容旧解析器或处理极短纯文本时使用。 一、优先使用围栏代码块 围栏代码块用三个反引号 ```` ``` ```` 开始，三个反引号结束。开启围栏后同一行紧跟语言标识，例如： python def main(): print("hello
