Markdown 基础教程

为什么使用 Markdown

Markdown 用少量纯文本符号表达标题、列表、链接和强调。文件体积小、容易搜索，也能在许多笔记、文档与代码平台中保持相近结构。即使离开特定编辑器，源文件仍然可以直接阅读。

无序列表：表达并列关系

在每个条目前添加短横线和一个空格。它适合观点、素材、功能点等没有严格先后关系的内容。

- 用户输入原文
- 选择列表格式
- 检查转换结果

有序列表：表达步骤与次序

数字加英文句点表示有序列表。编号适合流程、教程和优先级，但它只能表达顺序，不能自动证明某一步一定正确。

1. 粘贴文字
2. 选择格式
3. 复制 Markdown

任务清单：区分待办与完成

任务框使用 - [ ] 表示未完成，使用 - [x] 表示完成。不同平台对勾选交互的支持不同，但源码含义清晰。

- [ ] 完成首页文案
- [x] 确认页面清单

多级大纲：用缩进表达父子关系

子项通常比父项多缩进两个或四个空格。层级越深，阅读和迁移越容易出错；只在原文确实存在从属关系时使用嵌套。

- HTTP 基础
  - 请求
    - 方法与 URL
  - 响应
    - 状态码与正文

常见错误与检查方法

• 符号后没有空格：-条目 可能不会被识别为列表。
• 缩进混乱：同一级项目使用不同空格数，会导致渲染结构变化。
• 把编号当事实：自动编号只表示顺序，不代表优先级已经过确认。
• 直接嵌入 HTML：为降低脚本和事件属性风险，文序预览不执行输入中的原始 HTML。
• 只看预览：导出前同时检查源码，确认任务框、缩进和链接文本符合目标平台要求。