第1章：Markdown简介与基础语法Markdown教程（P1）
1.1 什么是Markdown？
Markdown 是一种轻量级标记语言，通过简单的符号（如 #、*、>）快速格式化文本，可转换为HTML或其他格式。它的核心目标是：
- 易读易写：纯文本中直接添加格式，无需复杂代码。
- 跨平台兼容：支持几乎所有编辑器、协作工具（如GitHub、Notion）和静态网站生成器（如Hexo、Hugo）。
1.2 为什么选择Markdown？
- 高效：比Word等富文本编辑器更专注于内容创作。
- 通用性：兼容代码仓库文档（README.md）、笔记软件（Obsidian）、博客写作等场景。
- 未来友好：纯文本永不过时，且可版本控制（如Git）。
1.3 基础语法示例
1.3.1 标题
# 一级标题 ## 二级标题 ### 三级标题
效果：
一级标题
二级标题
三级标题
1.3.2 段落与换行
- 段落：直接输入文字，段落间空一行。
- 换行：行尾添加两个空格或空一行。
这是第一段（末尾无空格） 这是同一段的强制换行（末尾两空格） 这是新段落（空一行分隔）
1.3.3 粗体与斜体
**粗体文本** 或 __粗体文本__ *斜体文本* 或 _斜体文本_ ***粗体且斜体***
效果：
粗体文本 斜体文本 粗体且斜体
1.4 小练习
尝试用Markdown编写以下内容：
- 一个二级标题“今日任务”
- 一段包含粗体（“重要”）和斜体（“紧急”）的文字
- 用换行分隔两个短句
提示：
- 使用
#控制标题层级，注意#后加空格。 - 符号（
*或_）要紧贴文字，中间无空格。
第2章：进阶格式与结构化元素Markdown教程（P2）
2.1 列表：有序与无序
[]2.1.1 无序列表
使用 -、* 或 + 符号（推荐统一使用 -）：
- 苹果 - 香蕉 - 小香蕉（子项缩进两空格） - 橙子
效果：
苹果
香蕉
- 小香蕉
橙子
2.1.2 有序列表
用数字加 . 标记，实际渲染自动修正序号：
1. 第一步 2. 第二步 5. 第三步（故意写错，仍显示为3.）
效果：
- 第一步
- 第二步
- 第三步
2.2 区块引用
用 > 标记引用内容，支持嵌套：
> 这是一级引用 > 多行需每行加 `>` > > 这是嵌套的二级引用 > 回到一级引用
效果：
这是一级引用
多行需每行加>这是嵌套的二级引用
回到一级引用
2.3 代码与语法高亮
2.3.1 行内代码
用反引号 ` 包裹：
在Python中，用`print("Hello World")`输出内容。
效果：
在Python中，用print("Hello World")输出内容。
2.3.2 代码块
用三个反引号 ``` 包裹，并指定语言（可选）：
def hello():
print("Hello Markdown!")效果：
def hello(): print("Hello Markdown!")
2.4 常见问题与技巧
列表与段落混合：列表项内换段需缩进4空格或一个制表符：
- 列表项 这是同一项内的新段落转义特殊符号：用
\避免符号被解析，如\*不倾斜\*显示为 不倾斜。
2.5 小练习
- 创建一个有序列表，包含“起床”“刷牙”“吃早餐”
- 用区块引用嵌套一个无序列表
- 写一段包含行内代码（如
git status）的句子
第3章：链接、图片与表格Markdown教程（P3）
3.1 超链接
3.1.1 行内链接
用 [显示文本](URL) 格式：
访问[谷歌](https://www.google.com)搜索。
效果：
访问谷歌搜索。
3.1.2 引用式链接
先定义链接标识符，再引用：
这是[百度][baidu-link]的引用方式。 [baidu-link]: https://www.baidu.com "百度官网"
效果：
（有的MD渲染器不支持这个功能）
这是[百度][baidu-link]的引用方式。
[baidu-link]: https://www.baidu.com “百度官网”
3.2 插入图片
语法与链接类似，前加 !：
示例：
效果：
（因无法加载图片，此处显示替代文本“熊猫”）
高级技巧：
使用图床（如Imgur、阿里云OSS）托管图片，避免本地路径问题。
引用式图片：
![Logo][logo] [logo]: /assets/logo.png "公司Logo"
3.3 表格
3.3.1 基础表格
用 | 分隔列，- 分隔表头与内容，冒号 : 控制对齐：
| 左对齐 | 居中对齐 | 右对齐 | | :----- | :------: | -----: | | 单元格 | 单元格 | 单元格 | | 内容 | 内容 | 100 |
| 效果： | | |
| 左对齐 | 居中对齐 | 右对齐 |
|---|---|---|
| 单元格 | 单元格 | 单元格 |
| 内容 | 内容 | 100 |
这里似乎也没渲染正确：
[
image630×332 11 KB
](https://linux.do/uploads/default/original/4X/c/3/9/c3922cf32b8af240daf44d9470a1b5df9dff1a75.png “image”)
3.3.2 快速生成工具
手动对齐繁琐，可用在线工具（如Tables Generator）生成代码。
3.4 分割线与注释
分割线：用三个及以上
-或*：--- ***效果：
注释（部分平台支持）：
<!-- 这是隐藏的注释 -->
3.5 小练习
- 插入一个指向GitHub的引用式链接
- 创建一个包含两列（“项目”“价格”）的右对齐表格
- 用分割线分隔两个段落
第4章：高级技巧与扩展语法Markdown教程（P4）
[]4.1 扩展语法（部分平台支持）
不同平台（如GitHub、Typora）可能支持额外语法，需注意兼容性。
[]4.1.1 任务列表
用 - [ ] 或 - [x] 标记未完成/已完成任务：
- [x] 写大纲 - [ ] 写正文 - [ ] 校对
效果：
- 写大纲
- 写正文
- 校对
[]4.1.2 流程图与图表（需特定渲染器）
例如 Mermaid 语法：
```mermaid graph LR A[起床] --> B(刷牙) B --> C{今天有课吗?} C -->|是| D[去学校] C -->|否| E[玩游戏] ```
效果（需支持Mermaid的平台，L站居然支持！）：
[
image1360×404 19.9 KB
](https://linux.do/uploads/default/original/4X/d/8/1/d8138235c58d289cccac389f397a24888e33c044.png “image”)
[]4.2 嵌入HTML
Markdown允许直接插入HTML标签，用于精细控制样式：
这是<span style="color:red">红色文字</span>。 <u>下划线</u>或<small>小号字</small>。
效果（需支持HTML的平台）：
这是红色文字。
下划线或小号字。
[]4.3 自动生成目录（部分**工!具!**支持）
使用 [TOC] 或特定标记（如Typora）：
## 目录 [TOC] ## 第一章...
效果：自动提取标题生成目录。
[]4.4 与GitHub的深度集成
[]4.4.1 GitHub Flavored Markdown (GFM)
- 代码高亮：在代码块标注语言类型即可。
- @提及：
@username触发通知。 - Issue与PR引用：
#123自动链接到对应Issue。
[]4.4.2 文件差异对比
用 diff 代码块：
- 删除的行
+ 新增的行效果：
- 删除的行 + 新增的行
[]4.5 效率工具推荐
- 编辑器：VS Code（+ Markdown插件）、Typora
- 图床工具：PicGo（自动上传图片生成链接）
- 校验工具：Markdownlint（检查语法规范）
[]4.6 小练习
- 创建一个任务列表，包含“学习Markdown”“写笔记”“提交作业”
- 用HTML标签为文字添加绿色背景（
<span style="background:lightgreen">） - 尝试在本地Markdown编辑器中生成目录