markdown语法规则(.md文件)

最新推荐文章于 2025-04-14 10:00:29 发布

书香水墨

最新推荐文章于 2025-04-14 10:00:29 发布

阅读量8.8k

点赞数 12

分类专栏： Notes 文章标签： markdown md .md TOC

本文链接：https://blog.csdn.net/qq_27870421/article/details/86541868

版权

Notes 专栏收录该内容

40 篇文章

订阅专栏

markdown语法

零、markdown是什么

 Markdown是一种纯文本格式的标记语言。通过简单的标记语法，它可以使普通文本内容具有一定的格式。
 文档后缀为.md。

一、标题

在想要设置为标题的文字前面加#来表示一个标题。
一个#是一级标题，二个#是二级标题，以此类推。支持六级标题。
注：标准语法一般在<kbd>#</kbd>后跟个空格再写文字。

+ 示例

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

+ 效果
在这里插入图片描述

二、字体

+ 语法

**这是加粗的文字** __这是加粗的文字__
*这是倾斜的文字*
***这是斜体加粗的文字***
~~这是加删除线的文字~~
==标记文本==
> 引用文本
H~2~O is是液体。
2^10^ 运算结果是 1024.

+ 效果
这是加粗的文字 这是加粗的文字
这是倾斜的文字`
这是斜体加粗的文字
~~这是加删除线的文字~~
标记文本

引用文本

H₂O is是液体。
2¹⁰ 运算结果是 1024.

三、引用

+ 在引用的文字前加>即可。引用也可以嵌套，如加两个>>三个>>>
+ 示例：

>这是引用的内容
>>这是引用的内容
>>>>>>>>>>这是引用的内容

+ 效果：

这是引用的内容

这是引用的内容

这是引用的内容

四、分割线

+ 三个或者三个以上的 - 或者 * 都可以。
+ 示例：

---
----
***
*****

+ 效果:

五、图片

+ 语法：

![图片alt](图片地址#pic_center =300x100 ''图片title'')

图片alt就是显示在图片下面的文字，相当于对图片内容的解释。
图片title是图片的标题，当鼠标移到图片上时显示的内容。title可加可不加

markdown显示图片

六、超链接

+ 语法：

[超链接名](超链接地址 "超链接title")
title可加可不加

+ 示例：

[百度](http://baidu.com)

+ 效果：
百度

七、列表

1、无序列表

+语法：

无序列表用 - + * 任何一种都可以
- 列表内容
+ 列表内容
* 列表内容

注意：- + * 跟内容之间都要有一个空格

+ 效果：

列表内容

列表内容

列表内容

2、有序列表

+语法：

数字加点

1.列表内容
2.列表内容
3.列表内容

注意：序号跟内容之间要有空格

+ 效果：

 1.列表内容
 2.列表内容
 3.列表内容

+ 列表嵌套

上一级和下一级之间敲三个空格即可
+ 列表内容
   + 列表内容

+ 效果：

列表内容
- 列表内容

+ 选择框

- [ ] 计划任务
- [x] 完成任务

+ 效果：

计划任务
完成任务

八、表格

+ 语法：

使用`:---------:`居中
使用`:----------`居左
使用`----------:`居右

表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容 

第二行分割表头和内容。
- 有一个就行，为了对齐，多加了几个
文字默认居左
-两边加：表示文字居中
-右边加：表示文字居右
注：原生的语法两边都要用 | 包起来。此处省略

+ 示例：

姓名|技能|排行
--|:--:|--:
刘备|哭|大哥
关羽|打|二哥
张飞|骂|三弟

+ 效果:

姓名	技能	排行
刘备	哭	大哥
关羽	打	二哥
张飞	骂	三弟

九、代码

+ 语法：

 单行代码：代码之间分别用一个反引号包起来
 `代码内容`

 <kbd>标识文字</kbd>

代码块：代码之间分别用三个反引号包起来，且两边的反引号单独占一行
\```
  代码...
  代码...
  代码...
\```

效果：
代码内容

 代码...
 代码...
 代码...

代码内容

十、注释

+ 语法

给HTML鼠标移动上去时添加解释。[^1]
*[HTML]: 超文本标记语言
[^1]: 注释的脚本

+ 效果
Markdown将文本转换为 HTML¹。

十一、 URL图表

可以使用UML图表进行渲染。 Mermaid. 例如下面产生的一个序列图

```mermaid
sequenceDiagram
张三 ->> 李四: 你好！李四, 最近怎么样?
李四-->>王五: 你最近怎么样，王五？
李四--x 张三: 我很好，谢谢!
李四-x 王五: 我很好，谢谢!
Note right of 王五: 李四想了很长时间, 文字太长了<br/>不适合放在一行.

李四-->>张三: 打量着王五...
张三->>王五: 很好... 王五, 你怎么样?
\```
注意：实际使用的时候去掉\```中的 \

+ 下列代码将产生一个流程图:

```mermaid
graph LR
A[长方形] -- 链接 --> B((圆))
A --> C(圆角长方形)
B --> D{菱形}
C --> D
\```

关于 Mermaid 语法，参考这儿,

十二、FLowchart流程图

flowchart的流程图：

```mermaid
flowchat
st=>start: 开始
e=>end: 结束
op=>operation: 我的操作
cond=>condition: 确认？

st->op->cond
cond(yes)->e
cond(no)->op
\```

关于 Flowchart流程图 语法，参考这儿.

十三、KaTeX数学公式

您可以使用渲染LaTeX数学表达式 KaTeX:

Gamma公式展示 $\Gamma(n) = (n-1)!\quad\forall
n\in\mathbb N$ 是通过欧拉积分
$$
\Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,.
$$

Gamma公式展示 $\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$ 是通过欧拉积分

$\Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,.$

你可以找到更多关于的信息 LaTeX 数学表达式here.

十四、新的甘特图功能，丰富你的文章

```mermaid
gantt
        dateFormat  YYYY-MM-DD
        title Adding GANTT diagram functionality to mermaid
        section 现有任务
        已完成               :done,    des1, 2014-01-06,2014-01-08
        进行中               :active,  des2, 2014-01-09, 3d
        计划一               :         des3, after des2, 5d
        计划二               :         des4, after des3, 5d
\```

关于 甘特图 语法，参考这儿

功能快捷键

撤销：Ctrl/Command + Z
重做：Ctrl/Command + Y
加粗：Ctrl/Command + B
斜体：Ctrl/Command + I
标题：Ctrl/Command + Shift + H
无序列表：Ctrl/Command + Shift + U
有序列表：Ctrl/Command + Shift + O
检查列表：Ctrl/Command + Shift + C
插入代码：Ctrl/Command + Shift + K
插入链接：Ctrl/Command + Shift + L
插入图片：Ctrl/Command + Shift + G