简介

Markdown 是一种轻量级标记语言，排版语法简洁，让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档，可与 HTML 混编，可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写，Markdown 被大量使用，如 GitHub、Wikipedia、简书等。

Markdown 的语法十分简单，常用的标记符号不超过十个，用于日常写作记录绰绰有余，不到半小时就能完全掌握。就是这十个不到的标记符号，却能让人优雅地沉浸式记录，专注内容而不是纠结排版，达到「心中无尘，码字入神」的境界。

基本语法

标题

使用 # 号可表示 1-6 级标题，一级标题对应一个 # 号，二级标题对应两个 # 号，以此类推。

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

段落

段落的前后要有空行，所谓的空行是指没有文字内容的行。若想在段落内换行，可以在上一行末尾插入两个以上的空格然后回车。

这是第一段文字。
这是第二段文字。

换行

在行末插入两个或多个空格，然后按回车键，即可创建一个换行。

这是第一行
这是第二行

强调

Markdown 使用星号（*）和下划线（_）作为强调标记。

粗体：使用两个 * 或 _ 包围文本

**粗体文本**
__粗体文本__

斜体：使用一个 * 或 _ 包围文本

*斜体文本*
_斜体文本_

粗斜体：使用三个 * 或 _ 包围文本

***粗斜体文本***
___粗斜体文本___

引用

在段落开头使用 > 符号 ，然后后面紧跟一个空格符号：

> 这是一段引用文本

引用可以嵌套：

> 这是第一级引用
>> 这是第二级引用
>>> 这是第三级引用

列表

无序列表：使用 -、* 或 + 作为列表标记

- 第一项
- 第二项
- 第三项
* 第一项
* 第二项
* 第三项
+ 第一项
+ 第二项
+ 第三项

有序列表：使用数字并加上 . 号

1. 第一项
2. 第二项
3. 第三项

列表嵌套：在子列表项前添加四个空格或一个制表符

1. 第一项：
- 嵌套的第一个子项
- 嵌套的第二个子项
2. 第二项：
- 嵌套的第一个子项
- 嵌套的第二个子项

代码

行内代码：使用反引号 (`) 包围代码

这是一段带有 `行内代码` 的文本

代码块：使用三个反引号（```）包围代码块，并可以指定语言

```javascript
function add(x, y) {
return x + y;
}
```

分隔线

可以使用三个或更多的星号（*）、减号（-）或下划线（_）单独在一行上创建分隔线：

***
---
___

链接

行内链接：方括号 + 圆括号

[链接文本](https://www.example.com)

带标题的链接：链接标题会在鼠标悬停时显示

[链接文本](https://www.example.com "链接标题")

引用链接：

[链接文本][链接标识]
[链接标识]: https://www.example.com "链接标题"

自动链接：使用尖括号

<https://www.example.com>
<email@example.com>

链接本地文件：

1. 链接本地文件夹：使用相对路径

[进入文件夹](./folder/)

1. 链接本地文件：与网络链接类似，使用相对路径或绝对路径

[查看文档](./document.pdf)
[打开图片](/images/example.jpg)

1. 链接其他 Markdown 文件：

[阅读相关文档](./related-doc.md)

1. 跨目录链接：

[上级目录文件](../other-doc.md)
[子目录文件](./subfolder/doc.md)

注意：链接本地文件的实际效果取决于 Markdown 解析器和查看环境。在某些网络环境中（如 GitHub），本地文件链接可能无法正常工作。

图片

使用感叹号 ! 后接方括号（内为图片替代文本）和圆括号（内为图片URL）：


带有链接的图片：

[](链接URL)

添加本地图片：

在 Markdown 中添加本地图片与添加网络图片类似，只需使用相对路径或绝对路径：


解决本地图片无法显示问题：

1. 图片文件夹管理： 在 Markdown 文件所在目录创建专门的图片文件夹（如 images），将所有图片集中存放：

• 

1. 使用base64编码： 当需要确保图片始终可见时，可以将图片转换为base64编码格式直接嵌入文档：

• 

1. 使用相对路径： 确保图片路径与Markdown文档的相对位置正确：

• 
  
  

1. 使用图床工具： 将本地图片上传到云存储服务，然后使用图片链接。许多Markdown编辑器（如Typora）提供了自动上传图片到图床的功能：

• 

注意：本地图片在不同环境下的显示效果可能有差异，取决于Markdown解析器和查看工具。在分享文档时，使用图床或相对路径是较好的选择。

转义字符

使用反斜杠 \ 来转义特殊字符：

\* 这不是斜体 \*

可以转义的字符包括：

\ 反斜线
` 反引号
* 星号
_ 下划线
{} 花括号
[] 方括号
() 小括号
# 井字号
+ 加号
- 减号
. 英文句点
! 感叹号

扩展语法

表格

使用 | 分隔单元格，使用 - 分隔表头和表体行：

| 表头1 | 表头2 | 表头3 |
| ----- | ----- | ----- |
| 单元格1 | 单元格2 | 单元格3 |
| 单元格4 | 单元格5 | 单元格6 |

效果如下：

设置对齐方式：

| 左对齐 | 居中对齐 | 右对齐 |
| :----- | :------: | -----: |
| 内容1 | 内容2 | 内容3 |

效果如下：

任务列表

使用 - [ ] 和 - [x] 语法创建任务列表：

- [x] 已完成任务
- [ ] 未完成任务
- [ ] 待办事项

数学公式

行内公式使用单个 $ 包围：

变量 $x$ 的平方是 $x^2$

独立公式使用两个 $ 包围：

$
E = mc^2
$

示例公式：

矩阵示例：

Mermaid 图表

Mermaid 是一种用于生成图表的 Markdown 扩展语法。

流程图：

flowchart TD
A[开始] --> B{判断条件}
B -->|条件1| C[处理1]
B -->|条件2| D[处理2]
C --> E[结束]
D --> E

序列图：

sequenceDiagram
用户->>系统: 发起请求
系统->>数据库: 查询数据
数据库-->>系统: 返回结果
系统-->>用户: 显示结果

类图：

classDiagram
类A <|-- 类B
类A : +int 属性1
类A : +方法1()
类B : +方法2()

甘特图：

gantt
title 项目计划
dateFormat YYYY-MM-DD
section 第一阶段
需求分析 :a1, 2023-01-01, 10d
设计 :a2, after a1, 15d
section 第二阶段
开发 :a3, after a2, 20d
测试 :a4, after a3, 10d

HTML 与 Markdown 混用

许多 Markdown 应用允许在 Markdown 格式文本中使用 HTML 标签，这在需要调整元素属性时非常有用。

这是 <span style="color:red">红色</span> 文本。
<table>
<tr>
<td>单元格1</td>
<td>单元格2</td>
</tr>
</table>

HTML 使用注意事项：

1. 出于安全原因，并非所有 Markdown 应用都支持在 Markdown 文档中使用 HTML。
2. 块级 HTML 元素（如 <div>、<table>、<pre>、<p> 等）前后必须有空行。
3. 块级 HTML 元素的开始和结束标签不应该用制表符或空格缩进。
4. 在块级 HTML 标签内不能使用 Markdown 语法。例如 <p>italic and **bold**</p> 将不起作用。

最佳实践

1. 保持简洁：使用 Markdown 的主要目的是关注内容而非格式。
2. 一致性：在整个文档中保持格式一致。
3. 段落分隔：使用空行分隔段落，提高可读性。
4. 标题层级：合理使用标题层级，不要跳过标题级别。
5. 预览检查：经常预览文档，确保格式正确。
6. 版本控制：对于重要文档，考虑使用版本控制系统（如 Git）。
7. 备份文档：定期备份 Markdown 文件，避免数据丢失。
8. 规范注释：使用清晰的注释解释复杂内容。

通过掌握这些 Markdown 语法，您可以创建结构清晰、格式优美的文档，专注于内容创作而非排版格式。Markdown 提供了一种既简单又功能强大的方式来编写各种文档，从简单的笔记到复杂的技术文档都可以轻松应对。

#markdown格式[搜索高亮]#