一、Markdown基础知识
1.1 什么是Markdown
Markdown是一种轻量级标记语言,使用纯文本格式编写文档。
【优点】:
✓ 纯文本,兼容性好
✓ 语法简单,易学易用
✓ 专注内容,不被格式干扰
✓ 版本控制友好(Git等)
【缺点】:
✗ 格式能力有限(如颜色、字体)
✗ 不同渲染器支持程度不同
✗ 复杂排版需要借助HTML
1.2 重要提醒
⚠️ Markdown原生不支持文字颜色!
要实现颜色效果,需要:
1. 使用HTML标签(推荐)
2. 使用特定平台的扩展语法
3. 某些Markdown编辑器的私有语法
本文档会详细介绍所有可行方法。
二、基础语法
2.1 标题(Headings)
语法 :使用 # 号,数量代表级别
markdown
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
效果:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
注意事项:
#号后面要加空格- 最多支持6级标题
- 建议标题前后空一行
2.2 段落和换行
段落:
markdown
这是第一段。
这是第二段(中间空一行)。
效果:
这是第一段。
这是第二段(中间空一行)。
换行:
markdown
方法1:行末加两个空格
然后换行
方法2:使用<br>标签
这是第一行<br>这是第二行
方法3:使用<br/>标签
这是第一行<br/>这是第二行
效果:
方法1:行末加两个空格
然后换行
方法2:使用
标签
这是第一行
这是第二行
2.3 文字格式化
2.3.1 加粗(Bold)
语法 :使用 ** 或 __ 包围
markdown
**这是加粗文字**
__这也是加粗文字__
效果:
这是加粗文字
这也是加粗文字
2.3.2 斜体(Italic)
语法 :使用 * 或 _ 包围
markdown
*这是斜体文字*
_这也是斜体文字_
效果:
这是斜体文字
这也是斜体文字
2.3.3 加粗+斜体
语法 :使用 *** 或 ___ 包围
markdown
***这是加粗斜体文字***
___这也是加粗斜体文字___
效果:
这是加粗斜体文字
这也是加粗斜体文字
2.3.4 删除线(Strikethrough)
语法 :使用 ~~ 包围
markdown
~~这是删除线文字~~
效果:
这是删除线文字
2.3.5 下划线(Underline)
语法:Markdown原生不支持,需要使用HTML
markdown
<u>这是下划线文字</u>
效果:
++这是下划线文字++
2.3.6 高亮(Highlight)
语法 :使用 == 包围(部分渲染器支持)
markdown
==这是高亮文字==
效果(如果不支持,会显示为普通文字):
这是高亮文字
备用方案(使用HTML):
markdown
<mark>这是高亮文字</mark>
效果:
这是高亮文字
2.3.7 上标和下标
语法:使用HTML标签
markdown
H<sub>2</sub>O(水的化学式)
X<sup>2</sup>(X的平方)
效果:
H2O(水的化学式)
X2(X的平方)
三、文字颜色(重点)
3.1 核心问题
❌ Markdown原生语法不支持文字颜色!
原因:
Markdown设计理念是"内容与格式分离"
专注于文档结构,不关注视觉样式
但可以通过以下方法实现颜色:
✓ HTML标签(最通用)
✓ 平台特定语法(如某些博客平台)
✓ 内联CSS样式
3.2 方法1:HTML <font> 标签(简单但已废弃)
语法:
markdown
<font color="red">这是红色文字</font>
<font color="blue">这是蓝色文字</font>
<font color="green">这是绿色文字</font>
<font color="#FF5733">这是橙色文字(十六进制)</font>
效果:
这是红色文字
这是蓝色文字
这是绿色文字
这是橙色文字(十六进制)
注意:
- ⚠️
<font>标签在HTML5中已废弃 - 但大部分Markdown渲染器仍支持
- 不推荐在正式项目中使用
3.3 方法2:HTML <span> 标签 + style(推荐)
语法:
markdown
<span style="color: red;">这是红色文字</span>
<span style="color: blue;">这是蓝色文字</span>
<span style="color: green;">这是绿色文字</span>
<span style="color: #FF5733;">这是橙色文字</span>
<!-- 带背景色 -->
<span style="color: white; background-color: red;">白字红底</span>
<span style="color: black; background-color: yellow;">黑字黄底</span>
<!-- 多种样式组合 -->
<span style="color: red; font-weight: bold; font-size: 20px;">红色加粗大号字</span>
效果:
这是红色文字
这是蓝色文字
这是绿色文字
这是橙色文字
白字红底
黑字黄底
红色加粗大号字
常用颜色代码:
| 颜色名 | 英文名 | 十六进制 | RGB |
|---|---|---|---|
| 红色 | red | #FF0000 | rgb(255, 0, 0) |
| 绿色 | green | #00FF00 | rgb(0, 255, 0) |
| 蓝色 | blue | #0000FF | rgb(0, 0, 255) |
| 黄色 | yellow | #FFFF00 | rgb(255, 255, 0) |
| 橙色 | orange | #FFA500 | rgb(255, 165, 0) |
| 紫色 | purple | #800080 | rgb(128, 0, 128) |
| 灰色 | gray | #808080 | rgb(128, 128, 128) |
| 黑色 | black | #000000 | rgb(0, 0, 0) |
| 白色 | white | #FFFFFF | rgb(255, 255, 255) |
3.4 方法3:使用Emoji替代颜色(创意方法)
语法:
markdown
🔴 红色重要提示
🟢 绿色成功信息
🟡 黄色警告信息
🔵 蓝色普通信息
⚫ 黑色严重问题
⚪ 白色次要信息
✅ 成功
❌ 失败
⚠️ 警告
🔥 热门
⭐ 重要
💡 提示
效果:
🔴 红色重要提示
🟢 绿色成功信息
🟡 黄色警告信息
🔵 蓝色普通信息
⚫ 黑色严重问题
⚪ 白色次要信息
✅ 成功
❌ 失败
⚠️ 警告
🔥 热门
⭐ 重要
💡 提示
3.5 方法4:代码块彩色输出(特殊场景)
语法:使用diff语法高亮
markdown
```diff
+ 这是绿色文字(添加)
- 这是红色文字(删除)
! 这是橙色文字(警告)
# 这是灰色文字(注释)
```
效果:
diff
+ 这是绿色文字(添加)
- 这是红色文字(删除)
! 这是橙色文字(警告)
# 这是灰色文字(注释)
四、列表
4.1 无序列表(Unordered List)
语法 :使用 -、* 或 +
markdown
- 项目1
- 项目2
- 项目3
- 子项目1(缩进2空格或1个Tab)
- 子项目2
- 子子项目1
* 也可以用星号
+ 也可以用加号
效果:
- 项目1
- 项目2
- 项目3
- 子项目1
- 子项目2
- 子子项目1
4.2 有序列表(Ordered List)
语法 :使用数字 + .
markdown
1. 第一项
2. 第二项
3. 第三项
1. 子项1(缩进3空格)
2. 子项2
4. 第四项
效果:
- 第一项
- 第二项
- 第三项
- 子项1
- 子项2
- 第四项
4.3 任务列表(Task List)
语法 :使用 - [ ] 和 - [x]
markdown
- [ ] 未完成任务
- [x] 已完成任务
- [ ] 待办事项1
- [x] 已完成事项1
- [ ] 子任务1
- [x] 子任务2
效果:
- 未完成任务
- 已完成任务
- 待办事项1
- 已完成事项1
- 子任务1
- 子任务2
五、链接和图片
5.1 链接(Links)
基本语法:
markdown
[链接文字](URL)
示例:
[百度](https://www.baidu.com)
[Google](https://www.google.com)
效果:
带标题的链接:
markdown
[链接文字](URL "鼠标悬停显示的标题")
示例:
[百度](https://www.baidu.com "点击访问百度")
效果:
引用式链接:
markdown
这是一个[链接][id]
[id]: https://www.baidu.com "百度"
效果:
这是一个链接
自动链接:
markdown
<https://www.baidu.com>
<example@email.com>
效果:
https://www.baidu.com
example@email.com
5.2 图片(Images)
基本语法:
markdown

示例:

带标题的图片:
markdown

示例:
![]失https://v败a.pla能有防盗链机制,建议将图片保存下来直接上传(https://www.baidu.com)
**使用HTML调整图片大小**:
```markdown
<img src="https://via.placeholder.com/150" width="100" height="100">
<img src="https://via.placeholder.com/150" width="50%">
六、代码
6.1 行内代码(Inline Code)
语法 :使用反引号 `````
markdown
使用 `console.log()` 打印日志
效果:
使用 console.log() 打印日志
6.2 代码块(Code Block)
语法1:缩进4个空格或1个Tab
markdown
function hello() {
console.log("Hello World");
}
语法2:使用三个反引号(推荐)
markdown
```
function hello() {
console.log("Hello World");
}
```
效果:
function hello() {
console.log("Hello World");
}
6.3 语法高亮(Syntax Highlighting)
语法:在三个反引号后面加语言名称
markdown
```javascript
function hello() {
console.log("Hello World");
}
```
```python
def hello():
print("Hello World")
```
```java
public class Hello {
public static void main(String[] args) {
System.out.println("Hello World");
}
}
```
```sql
SELECT * FROM users WHERE id = 1;
```
```bash
echo "Hello World"
ls -la
```
```json
{
"name": "example",
"version": "1.0.0"
}
```
效果:
javascript
function hello() {
console.log("Hello World");
}
python
def hello():
print("Hello World")
java
public class Hello {
public static void main(String[] args) {
System.out.println("Hello World");
}
}
6.4 显示代码块本身(转义)
问题:如何在Markdown中显示代码块语法本身?
解决:使用更多的反引号包围
markdown
````markdown
```javascript
console.log("hello");
```
````
七、表格(Tables)
7.1 基本表格
语法:
markdown
| 列1 | 列2 | 列3 |
| --- | --- | --- |
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |
效果:
| 列1 | 列2 | 列3 |
|---|---|---|
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |
7.2 对齐方式
语法:
markdown
| 左对齐 | 居中对齐 | 右对齐 |
| :--- | :---: | ---: |
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |
效果:
| 左对齐 | 居中对齐 | 右对齐 |
|---|---|---|
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |
7.3 表格中使用格式化
语法:
markdown
| 功能 | 语法 | 说明 |
| --- | --- | --- |
| **加粗** | `**文字**` | 重点强调 |
| *斜体* | `*文字*` | 一般强调 |
| `代码` | `` `代码` `` | 代码片段 |
| [链接](https://baidu.com) | `[文字](URL)` | 超链接 |
效果:
| 功能 | 语法 | 说明 |
|---|---|---|
| 加粗 | **文字** |
重点强调 |
| 斜体 | *文字* |
一般强调 |
代码 |
代码 |
代码片段 |
| 链接 | [文字](URL) |
超链接 |
7.4 表格技巧
1. 表格可以不对齐(但对齐更易读)
markdown
| 列1 | 列2 |
|---|---|
| 短 | 很长很长很长的内容 |
2. 表格中换行
markdown
| 列1 | 列2 |
| --- | --- |
| 第一行<br>第二行 | 内容 |
效果:
| 列1 | 列2 |
|---|---|
| 第一行 第二行 | 内容 |
3. 表格中使用颜色
markdown
| 状态 | 说明 |
| --- | --- |
| <span style="color: green;">成功</span> | 操作成功 |
| <span style="color: red;">失败</span> | 操作失败 |
效果:
| 状态 | 说明 |
|---|---|
| 成功 | 操作成功 |
| 失败 | 操作失败 |
八、引用(Blockquotes)
8.1 基本引用
语法 :使用 >
markdown
> 这是一段引用文字
效果:
这是一段引用文字
8.2 多段引用
语法:
markdown
> 第一段引用
>
> 第二段引用
效果:
第一段引用
第二段引用
8.3 嵌套引用
语法:
markdown
> 第一层引用
>> 第二层引用
>>> 第三层引用
效果:
第一层引用
第二层引用
第三层引用
8.4 引用中使用其他语法
语法:
markdown
> ## 引用中的标题
>
> - 列表项1
> - 列表项2
>
> **加粗文字** 和 *斜体文字*
>
> ```javascript
> console.log("代码块");
> ```
效果:
引用中的标题
- 列表项1
- 列表项2
加粗文字 和 斜体文字
javascriptconsole.log("代码块");
九、分隔线(Horizontal Rules)
语法 :使用三个或以上的 -、* 或 _
markdown
---
***
___
效果:
十、转义字符(Escaping)
10.1 需要转义的字符
问题:如何显示Markdown的特殊字符本身?
语法 :使用反斜杠 \
markdown
\*这不是斜体\*
\**这不是加粗\**
\# 这不是标题
\- 这不是列表
\[这不是链接\](url)
效果:
*这不是斜体*
*这不是加粗*
这不是标题
- 这不是列表
这不是链接\](url) #### 10.2 可转义的字符列表 | 字符 | 名称 | |-------|-----| | `\` | 反斜杠 | | ````` | 反引号 | | `*` | 星号 | | `_` | 下划线 | | `{}` | 花括号 | | `[]` | 方括号 | | `()` | 圆括号 | | `#` | 井号 | | `+` | 加号 | | `-` | 减号 | | `.` | 点号 | | `!` | 感叹号 | | \` | \` | *** ** * ** *** ### 十一、高级技巧 #### 11.1 HTML标签(万能方法) **重要提示**: 大部分Markdown渲染器支持HTML标签 可以使用HTML实现Markdown无法实现的功能 **常用HTML标签**: ```markdown 红色文字 大号文字 特定字体
第二行 使用 多个空格
点击展开
这是折叠的内容| 左边的内容 - 列表1 - 列表2 | 右边的内容 - 列表3 - 列表4 |