Markdown 新手指南¶
让文档写作像聊天一样简单 —— 从零开始掌握 Markdown 标记语言，轻松写出结构清晰、排版美观的文档。
教程简介¶
Markdown 是一种轻量级标记语言，由 John Gruber 于 2004 年创建。它用简洁的纯文本符号来表达格式，让你专注于内容而非排版。无论是写技术文档、记笔记、发博客还是写 README，Markdown 都是现代开发者的必备技能。
为什么学 Markdown？
- 极低的学习成本：核心语法只需 10 分钟就能掌握
- 跨平台通用：GitHub、Notion、Obsidian、Typora 等几乎所有写作工具都支持
- 纯文本格式：可以用任何编辑器打开，版本控制友好
- 导出灵活：可轻松转换为 HTML、PDF、Word 等格式
| 项目 | 内容 |
|---|---|
| 学习目标 | 掌握 Markdown 核心语法，能独立撰写结构清晰的技术文档 |
| 预计时长 | 4~6 小时 |
| 关键概念 | 标题、段落、列表、链接、图片、代码块、表格、引用 |
| 实践任务 | 撰写一篇完整的项目 README 文档 |
学习路径¶
本教程采用 场景驱动 的方式，每个章节围绕一个真实写作任务展开，让你在动手实践中自然掌握 Markdown：
| 章节 | 场景 | 你将学会 |
|---|---|---|
| 第 1 章：你的第一篇技术文档 | 写一份课程笔记 | 标题、段落、文字格式、引用、分隔线 |
| 第 2 章：打造项目主页 | 为开源项目写 README | 列表、链接、图片、代码块 |
| 第 3 章：团队协作文档 | 写周报和协作文档 | 表格、任务列表、脚注、HTML 混用 |
| 第 4 章：发布你的作品 | 发布技术博客 | 综合实战：博客、会议纪要、文档站点 |
快速预览¶
# 这是一级标题
## 这是二级标题
**这是粗体文字**，*这是斜体文字*。
- 无序列表项 1
- 无序列表项 2
1. 有序列表项 1
2. 有序列表项 2
[这是一个链接](https://example.com)
`这是行内代码`
```python
# 这是代码块
print("Hello, Markdown!")
```
渲染效果： 上面的纯文本经过 Markdown 渲染后，会变成带有层级标题、格式化文字、列表、链接和语法高亮代码块的漂亮文档。