Markdown新手入门到精通：语法、技巧与实战教程
第一章 什么是 Markdown
Markdown 是一种轻量级标记语言，由 John Gruber 于 2004 年创建。它用纯文本编写，通过简单的符号标记来实现排版，最终可以转换为 HTML、PDF 等多种格式。
核心优势：语法简单、易读易写、跨平台兼容、专注内容而非排版。
第二章 基础语法
2.1 标题
使用 # 号标记，数量代表层级（1~6 级）：
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
建议在
#后加一个空格，兼容性更好。
2.2 段落与换行
段落之间用空行分隔。
行末加两个空格后回车，可实现段内换行。
这是第一段。
这是第二段。
这是同一段内的
第二行（行末有两个空格）。
2.3 强调
| 效果 | 语法 | 说明 |
|---|---|---|
| 斜体 | *斜体* 或 _斜体_ | 单星号或单下划线 |
| 粗体 | **粗体** 或 __粗体__ | 双星号或双下划线 |
| 粗斜体 | ***粗斜体*** | 三个星号 |
| 删除线 | ~~删除线~~ | 双波浪线 |
2.4 列表
无序列表：使用 -、* 或 +：
- 项目一
- 项目二
- 子项目（缩进两个空格）
有序列表：数字 + 英文句点：
1. 第一步
2. 第二步
1. 子步骤
任务列表（扩展语法）：
- [x] 已完成
- [ ] 待完成
2.5 链接
[链接文本](https://example.com)
<!-- 带标题提示的链接 -->
[链接文本](https://example.com "鼠标悬停时显示")
<!-- 引用式链接 -->
[引用链接][ref_id]
[ref_id]: https://example.com
2.6 图片
<!-- 带尺寸的图片（部分渲染器支持 HTML） -->
<img src="图片URL" width="300" />
2.7 引用
> 这是一段引用
>
> 引用可以包含多个段落
>
> > 嵌套引用
2.8 代码
行内代码：使用反引号包裹，如 print("hello")。
代码块：使用三个反引号，并指定语言：
```python
def hello():
print("Hello, Markdown!")
```
2.9 分隔线
使用三个或以上的 -、* 或 _（独立成行）：
---
***
___
第三章 进阶语法
3.1 表格
| 左对齐 | 居中对齐 | 右对齐 |
| :--- | :---: | ---: |
| 内容 | 内容 | 内容 |
| 数据 | 数据 | 数据 |
| 左对齐 | 居中对齐 | 右对齐 |
|---|---|---|
| 内容 | 内容 | 内容 |
| 数据 | 数据 | 数据 |
:---左对齐:---:居中对齐---:右对齐
3.2 脚注
这是一段带脚注的文字。[^1]
[^1]: 这是脚注内容。
脚注是扩展语法，部分平台不支持。
3.3 定义列表（部分平台支持）
术语
: 术语的定义解释。
3.4 缩写（部分平台支持）
*[HTML]: 超文本标记语言
The HTML specification...
3.5 Emoji
:smile: :+1: :tada:
渲染效果：???? ???? ????
完整 Emoji 列表见 Emoji Cheat Sheet。
3.6 HTML 混写
Markdown 兼容原始 HTML，可以直接嵌入：
<div style="color: red;">红色文字</div>
<details>
<summary>点击展开</summary>
隐藏内容。
</details>
<kbd>Ctrl</kbd> + <kbd>C</kbd>
3.7 数学公式（LaTeX）
使用 $ 包裹行内公式，$$ 包裹块级公式：
行内公式：$E = mc^2$
块级公式：
$$
\int_0^\infty e^{-x^2} dx = \frac{\sqrt{\pi}}{2}
$$
渲染：
$$
\int_0^\infty e^{-x^2} dx = \frac{\sqrt{\pi}}{2}
$$
3.8 目录（TOC）
部分编辑器（如 Typora、VS Code 插件）支持自动生成目录：
[TOC]
<!-- 或 -->
[[toc]]
3.9 流程图与图表（Mermaid）
```mermaid
graph TD
A[开始] --> B{判断条件}
B -->|是| C[执行操作]
B -->|否| D[结束]
```
渲染：
是否开始判断条件执行操作结束
第四章 常用编辑器推荐
| 编辑器 | 平台 | 特点 | 适合人群 |
|---|---|---|---|
| Typora | Win/Mac/Linux | 所见即所得、简洁优雅 | 写作、笔记 |
| VS Code | Win/Mac/Linux | 插件丰富、Git 集成 | 开发者 |
| Obsidian | Win/Mac/Linux | 双向链接、知识图谱 | 知识管理 |
| Notion | Web/全平台 | 块编辑器、协作 | 团队协作 |
| MarkText | Win/Mac/Linux | 开源免费、Typora 替代 | 开源爱好者 |
| Ulysses | Mac/iOS | 专业写作工具 | 专业写作者 |
第五章 实用场景
5.1 技术文档编写
## API 接口说明
### 获取用户信息
**请求方式**：`GET`
**请求路径**：`/api/v1/user/{id}`
**路径参数**：
| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| id | integer | 是 | 用户 ID |
**返回示例**：
```json
{
"code": 0,
"data": {
"id": 1,
"name": "张三"
}
}
### 5.2 个人笔记
```markdown
# 2024 学习计划
> 每天进步一点点。
## 技术方向
- [ ] 深入理解 Go 并发模型
- [ ] 完成 LeetCode 100 题
- [ ] 阅读《设计模式之美》
## 阅读书单
| 书名 | 进度 | 笔记 |
|------|------|------|
| 《代码整洁之道》 | 60% | [笔记链接] |
| 《重构》 | 30% | [笔记链接] |
5.3 项目 README
# 项目名称
> 一句话描述项目。
## 快速开始
### 环境要求
- Node.js >= 18
- pnpm >= 8
### 安装
\```bash
git clone https://github.com/user/repo.git
cd repo
pnpm install
\```
### 运行
\```bash
pnpm dev
\```
第六章 最佳实践
规范文件名：使用小写字母 + 短横线，如
api-design-guide.md语义化标题结构：一个文档只有一个一级标题，下级标题按层级使用
善用空行：不同元素之间保留空行，提升源码可读性
代码块指定语言：确保高亮正确，如
```python图片使用相对路径：便于文档迁移和版本管理
链接检查：定期检查外部链接有效性
一页原则：单个 .md 文件不宜过长，超过 500 行考虑拆分
第七章 常见问题
Q1：行内代码中包含反引号怎么办？
使用双反引号包裹：
`` `反引号内的代码` ``
Q2：如何转义特殊字符？
使用反斜杠 \：
\* 这不是一个列表项
\# 这不是标题
Q3：列表嵌套代码块如何正确缩进？
代码块需要相对于列表项缩进：
1. 第一步
```python
# 这里有 3 个空格的缩进
print("hello")
第二步
### Q4：不同平台渲染结果不一样？
Markdown 没有统一标准，各平台（GitHub、GitLab、Typora、Notion）有各自的扩展。书写时尽量使用基础语法以保证最大兼容性，扩展语法需确认目标平台的渲染支持。
---
## 第八章 速查表
| 元素 | 语法 |
|------|------|
| 标题 | `# H1` `## H2` `### H3` |
| 粗体 | `**粗体**` |
| 斜体 | `*斜体*` |
| 删除线 | `~~删除线~~` |
| 无序列表 | `- 项目` |
| 有序列表 | `1. 项目` |
| 链接 | `[文本](URL)` |
| 图片 | `` |
| 引用 | `> 引用` |
| 行内代码 | `` `code` `` |
| 代码块 | ` ```语言 ` |
| 分隔线 | `---` |
| 表格 | `\| 列1 \| 列2 \|` |
| 任务列表 | `- [x] 完成` |
| 脚注 | `[^1]` |
| 转义 | `\` |
---
> 始于简洁，终于无限可能。
*（内容由AI生成，仅供参考）*
