注意:这并不是水文 只是单纯想要记录一下那些常用的MD语法

Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。如果你作为一名博客站长,那么它可是你必不可少的工具之一。

说明文档

创始人 John Gruber 的 Markdown 语法说明
Markdown中文文档

一.标题

标题能显示出文章的结构。行首插入1-6个 # ,每增加一个 # 表示更深入层次的内容,对应到标题的深度由 1-6 阶。当然#越多,标题的大小反而越小
H1 :# Header 1
H2 :## Header 2
H3 :### Header 3
H4 :#### Header 4
H5 :##### Header 5
H6 :###### Header 6

效果如下:

Header 1

Header 2

Header 3

Header 4

Header 5
Header 6

二.字体

1.加粗

要加粗的文字左右分别用两个*号包起来

2.斜体

要倾斜的文字左右分别用一个*号包起来

3.斜体加粗

要倾斜和加粗的文字左右分别用三个*号包起来

4.删除线

要加删除线的文字左右分别用两个~~号包起来

示例:

**这是加粗的文字**
*这是倾斜的文字*`
***这是斜体加粗的文字***
~~这是加删除线的文字~~

效果如下:

这是加粗的文字
这是倾斜的文字
这是斜体加粗的文字
这是加删除线的文字


三.列表

1.有序列表

1. 小明
2. 小王
3. 小刚

2.无序列表

- 小明
- 小王
- 小刚

效果如下:

  1. 小明
  2. 小王
  3. 小刚
  • 小明
  • 小王
  • 小刚

四.引用

直接在需要引用的内容前加上尖括号<即可,多少个<就是多少级引用,且可以一直引用下去。

> 一级引用
>> 二级引用
>>> 三级引用
>>>> 四级引用

效果如下:

一级引用

二级引用

三级引用

四级引用

五.图片/链接

图片

有2种方式:行内式和参数式

1.行内式

![我是名字](我是链接)

2.参数式

![我是名字](我是链接)
//图片参数
[我是名字]:我是链接

Ps:上述两种方法效果都是一样的。

链接

[]里为指向链接名称,()则为地址,注意大括号与小括号直接不能有空格。

[遇见孤独](https://blog.aenjoy.cn/)是一条咸鱼的个人博客。

效果如下:

遇见孤独是一条咸鱼的个人博客。


七.分割线

分割线可以由三个或以上-来表示。

----
------
--------
可以更长,但其效果是相同的。


八.代码块

当发布一些技术文章时,需要展示代码,这个语法是很重要的。

1.少量可以直接用`包裹起来,单行使用。

`Markdown是世界上最好的标记语言`

2.大量代码可以使用`包裹起来。

使用时将#删除即可。

# ```
Markdown是世界上最好的标记语言
Markdown是世界上最好的标记语言
Markdown是世界上最好的标记语言
# ```


九.表格

|姓名|年龄|大小| //这是表头
|:-|:-:|-:|
|小明|15|13cm| //这是表项
|小王|17|15cm| //这是表项
|小刚|19|17cm| //这是表项

效果如下:

姓名年龄大小
小明1513cm
小王1715cm
小刚1917cm

十.高级技巧

1.转义

Markdown 使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用转义字符,Markdown 使用反斜杠转义特殊字符:

**文本加粗** 
\*\* 正常显示星号 \*\*

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:

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

2.公式

当你需要在编辑器中插入数学公式时,可以使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现。提交后,问答和文章页会根据需要加载 Mathjax 对数学公式进行渲染。如:

$$
\mathbf{V}_1 \times \mathbf{V}_2 =  \begin{vmatrix} 
\mathbf{i} & \mathbf{j} & \mathbf{k} \\
\frac{\partial X}{\partial u} &  \frac{\partial Y}{\partial u} & 0 \\
\frac{\partial X}{\partial v} &  \frac{\partial Y}{\partial v} & 0 \\
\end{vmatrix}
${$tep1}{\style{visibility:hidden}{(x+1)(x+1)}}
$$

3.自动链接

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用方括号包起来, Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样,例如:

<http://example.com/>

Markdown 会转为:

<a href="http://example.com/">http://example.com/</a>

邮址的自动链接也很类似,只是 Markdown 会先做一个编码转换的过程,把文字字符转成 16 进位码的 HTML 实体,这样的格式可以糊弄一些不好的邮址收集机器人,例如:

<address@example.com>

Markdown 会转成:

<a href="&#x6D;&#x61;i&#x6C;&#x74;&#x6F;:&#x61;&#x64;&#x64;&#x72;&#x65;
&#115;&#115;&#64;&#101;&#120;&#x61;&#109;&#x70;&#x6C;e&#x2E;&#99;&#111;
&#109;">&#x61;&#x64;&#x64;&#x72;&#x65;&#115;&#115;&#64;&#101;&#120;&#x61;
&#109;&#x70;&#x6C;e&#x2E;&#99;&#111;&#109;</a>

在浏览器里面,这段字串(其实是 [address@example.com](mailto:address@example.com))会变成一个可以点击的address@example.com链接。

(这种作法虽然可以糊弄不少的机器人,但并不能全部挡下来,不过总比什么都不做好些。不管怎样,公开你的信箱终究会引来广告信件的。)


这篇文章内容参考了Markdown 语法说明 (简体中文版),在平常写文章当中,MD语法是我们不可缺少的伙伴,希望这篇文章可以为需要的人提供帮助。Markdown牛逼(逃