一文搞懂 Markdown 文档规则

村头的猫

于 2025-04-07 18:29:20 发布

阅读量1.8k

点赞数 29

文章标签： AI写作编辑器

本文链接：https://blog.csdn.net/m0_47221837/article/details/147049956

版权

markdown 是一种轻量级的「标记语言」，非常易于上手，通过书写简单的规则，轻松实现标准化样式，可实现灵活的个性化页面。

换行规则：可在段落前后多一个空行即可，多个换行仅作为一个换行处理。

一、标题规则

规则：不同级别标题在行首用 # 实现，注意#与文字之间需要保留至少一个空格，最多支持6级标题，如：

Markdown内容：

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

输出展示：

一级标题示例

二级标题示例

三级标题示例

四级标题示例

五级标题示例

六级标题示例

二、文字样式规则

粗体、斜体、删除线，需要在文字前后加不同的标记符号，如果未生效，请在符号两侧各加一个空格。如下：

Markdown内容：

*两侧各1个星号是斜体*

**两侧各2个星号是粗体**

***两侧各3个星号是粗体加斜体***

~~两侧各2个波浪线为删除线~~

输出展示：

两侧各1个星号是斜体

两侧各2个星号是粗体

两侧各3个星号是粗体加斜体

~~两侧各2个波浪线为删除线~~

三、列表规则

无序列表

规则1：在符号-后加空格实现。如：

Markdown内容：

- 无序列表 1
- 无序列表 2

输出展示：

无序列表 1
无序列表 2

规则2：列表层级，需在符号-前增加2个空格。如：

Markdown内容：

- 无序列表 1
- 无序列表 2
  - 无序列表 2.1
  - 无序列表 2.2

输出展示：

无序列表 1
无序列表 2
- 无序列表 2.1
- 无序列表 2.2

有序列表

规则：在数字及符号.后加空格后输入内容，后面的序号会根据第一个序号索引自动分别+1，如：

Markdown内容：

2. 有序列表 1
3. 有序列表 2
4. 有序列表 3
1. 有序列表 5

输出展示：

有序列表 1
有序列表 2
有序列表 3
有序列表 5

任务列表

规则：未完成事项以 - [ ] 开始，已完成事项以 - [x] 开始。注意这里的空格，如：

Markdown内容：

- [ ] 未完成 1
- [ ] 未完成 2
- [x] 已完成

输出展示：

未完成 1
未完成 2
已完成

列表混合示例

Markdown内容：

- 任务目标
  1. 目标 1
  2. 目标 2
- 完成情况 
  - [ ] 未完成
  - [x] 已完成
    - 完成效果: AI导航([ai-bar.cn](https://ai-bar.cn/))
    - 复盘链接

输出展示：

任务目标
1. 目标 1
2. 目标 2
完成情况
- 未完成
- 已完成
  - 完成效果: AI导航(ai-bar.cn)
  - 复盘链接

四、引用规则

规则：在符号 > 后面书写文字，连续行的 > 会放到一个引用块中。如果想在应用内换行可增加一个 > 空行。一行开头连续多个，如： >> 会生成嵌套引用。

Markdown内容：

> 大丈夫生居天地间，岂能郁郁久居人下。
>
> 俺也一样。

> 无人扶我青云志，我自踏雪至山巅。若是命中无此运，亦可孤身登昆仑。红尘赠我三尺剑，酒看瘦马一世街。世人朝路乃绝涧，独见众生止步前。海到尽头天作岸，山登绝顶我为峰。如若东山能再起，大鹏展翅九万里。一入红尘梦易真，一朝悟透心境名。一朝悟道见真我，昔日枷锁皆云烟。天门将至百运开，拂尘轻笑问仙来。
>> 俺也一样

输出展示：

大丈夫生居天地间，岂能郁郁久居人下。

俺也一样。

无人扶我青云志，我自踏雪至山巅。若是命中无此运，亦可孤身登昆仑。红尘赠我三尺剑，酒看瘦马一世街。世人朝路乃绝涧，独见众生止步前。海到尽头天作岸，山登绝顶我为峰。如若东山能再起，大鹏展翅九万里。一入红尘梦易真，一朝悟透心境名。一朝悟道见真我，昔日枷锁皆云烟。天门将至百运开，拂尘轻笑问仙来。

俺也一样

五、链接

规则：格式为 []()，其中[]内部放文字，()内部放链接，如：

Markdown内容：

[竹记写作](https://ai-bar.cn/zhuji)

输出展示：

竹记写作

六、图片

规则：格式为 ![]()，比链接前面多了个英文感叹号，其中[]内部放图片描述，主要用于搜索引擎检索，也可为空，()内部放图片链接地址，支持 jpg、png、gif、svg 等图片格式（csdn居然图片还要单独传~），如：

Markdown内容：

![](https://images.unsplash.com/photo-1530991671072-ac4f81c2c3c1?ixlib=rb-4.0.3&q=85&fm=jpg&crop=entropy&cs=srgb&dl=mariana-montes-de-oca-TDUpwlnUA5U-unsplash.jpg&w=1920)

输出展示：

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

七、分割线

规则：在一行开始用三个以上的减号创建 ---，同时在分隔线之上需空一行。如：

Markdown内容：

---

输出展示：

八、表格

规则：主要以 | 区分单元格，用 :- 或 :-: 或 -:加 | 来区分表头和表格内容，其中 - 至少有一个， : 表示表格单元格对应列的对齐方式。

:- 左对齐

:-: 居中对齐

-: 右对齐

Markdown内容：

| 职级     | 一般年龄 |  工龄 |
| :----   | :----:  | -----:|
| 高级牛马 |    24   |  3年  |
| 资深牛马 |    26   |  5年  |
| 专家牛马 |    30   |  10年 |
| 退休牛马 |    35   |  18年 |

输出展示：

职级	一般年龄	工龄
高级牛马	24	3年
资深牛马	26	5年
专家牛马	30	10年
退休牛马	35	18年

九、代码

行内代码规则：用单个反引号 ` 前后包裹，如：code

代码块规则：用三个反引号 ` 开始，其后跟语言类型，也可为空（会自动判断代码语言类型），需独占一行，再用三个反引号 ` 结束，也独占一行，两个独立行中间部分即为代码部分，如：

Markdown内容：

```js
class Apple extends Fruit {
  constructor(name){
    this.name = name
  }
}
```

输出展示：

class Apple extends Fruit {
  constructor(name){
    this.name = name
  }
}

不写语言类型也会自动判断语法并高亮，但是不一定准确

标题：# 一号标题
链接：[文字](链接)
图片：![文字](https://ai-bar.cn)

十、特殊用法

输出原始符号

如果希望输出反引号、星号等特殊符号，可以在对应字符前加一个反斜线，如： **这个文字不会加粗**
如果希望输出反斜线本身，同理写两个反斜线即可，如：\
如果希望展现markdown原始格式，可用前面介绍代码格式包裹，如：\*\* 可输出markdown原始字符，或代码块包裹：

\*\*文字不会加粗\*\*
\\
`\*\*`

自定义样式

居中

对于高级用户可以使用标签来做一些自定义，如<center>这句话居中展示</center>可实现居中展示：

Markdown内容：

<center>这句话居中展示</center>

输出展示：

这句话居中展示

连续多个换行

可用多个 <br /> 标签实现，如：

Markdown内容：

<br />
<br />
<br />

输出展示：

自定义颜色

可通过标签结合行内样式实现（行内样式CSDN貌似是不支持的），如：

Markdown内容：

<span style="color: red;">红色文字</span>、
<span style="color: #FFAABB;">指定色值</span>、
<span style="background: #FFAABB;">添加背景色</span>、

<span style="font-size: 20px">大号文字</span>、
<span style="font-size: 20px;font-weight: bold;background: linear-gradient(to right, #0000ff, #ff00ff);-webkit-background-clip: text;-webkit-text-fill-color: transparent;">加粗渐变的文字</span>

输出展示：

红色文字、
指定色值、
添加背景色、

大号文字、
加粗渐变的文字