markdown使用教程菜鸟

Markdown 是否值得用，判断标准很简单：如果内容以文字、列表、代码、链接为主，就用 Markdown；如果需要复杂分栏、精确打印版式、公文红头，应换用排版工具。新手先掌握标题、列表、链接、代码、表格五类语法，就能覆盖大多数笔记和文档场景。 ## 适用场景与工具选择 - 适合：笔记、README、项目说明、技术博客、论坛发帖、API 文档。 - 不适合：正式公文、复杂海报、需要严格分页或页眉页脚的文档。 - 工具选择：VS Code、Typora、Obsidian、在线 Markdown 编辑器均可。选择标准是：支持实时预览、支持 GFM、能导出 HTML 或 PDF。 - 注意：不同平台对 Markdown 扩展支持不同，发布到新平台前先确认表格、任务列表等扩展是否可用。 ## 标题、段落与换行 标题用 `#` 到 `######`。一个文档通常只保留一个一级标题，正文主要用二级及以下层级，避免跳级。 ## 功能说明 ### 安装步骤 段落之间用空行分隔。普通换行不会产生新段落；如果确实需要行内换行，可在行尾加两个空格，或使用 `
`，但部分平台不支持 `
`。 ## 列表与任务列表 无序列表用 `-`，有序列表用 `1.`。嵌套列表缩进两到四个空格： - 准备 - 下载 - 解压 1. 第一步 2. 第二步 任务列表写法如下： - [ ] 未完成 - [x] 已完成 任务列表属于 GFM 扩展，CommonMark 不原生支持；在不支持的环境下会退化为普通列表，发布前需确认目标平台。 ## 链接、图片与代码 - 链接：`[文字](https://example.com "标题")`，标题可省略。 - 图片：``。替代文字应描述图片内容，不能为空。 - 行内代码用反引号，例如：`npm install`。 - 代码块写法：先写三个反引号和语言名，再写代码，最后用三个反引号收尾。例如： python print("hello") 代码块语言名应与内容一致，否则在高亮显示时可能错乱。 ## 表格与引用 GFM 表格示例： | 功能 | 快捷键 | | --- | :---: | | 加粗 | Ctrl+B | 表格列数必须一致；单元格内出现 `|` 时要写成 `\|`。表格不适合放很长的段落，复杂表格建议直接使用 HTML。 引用用 `>`，可嵌套，适合放提示或风险说明： > 注意：Markdown 不是排版工具，不要用它追求像素级版面。 ## 发布前检查 发布前至少检查五项： - 标题层级是否跳级。 - 链接能否打开，图片是否显示。 - 代码块语言是否正确。 - 表格列数是否一致。 - 列表缩进是否错乱。 如果目标平台不支持 GFM 扩展，应减少使用表格和任务列表，或导出为 HTML 后再发布。 新手不必一次学完所有语法。先熟练标题、列表、链接、代码、表格这五类，就能满足大部分日常写作。选择支持实时预览的工具，边写边看渲染结果；遇到复杂版式，及时回到专门排版工具。