Hexo博客所用到的MD编辑器语法

hexo博客 评论

标题语法
段落语法
换行语法
强调语法
引用语法
列表语法
代码语法
分割线语法
链接语法
图片语法
转义字符语法
内嵌HTML标签
扩展语法

标题语法

标题前面加#号空格，几级标题就加几个#号，最后一个#号紧跟空格，最多有六级标题。如下：

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

段落语法

要创建段落，请使用空白行将一行或多行文本进行分隔。
不要用空格或制表符缩进段落。

换行语法

1
<br>

强调语法

粗体

要加粗文本请在要加粗的内容前后各添加两个*或者两个_
Markdown 应用程序在如何处理文字中间的下划线上并不一致。为兼容考虑，在文字中间部分加粗的话，请使用星号。

1
我**爱**豆

我爱豆

1
我__爱__豆

我__爱__豆

斜体

要用斜体显示文本，请在内容前后添加一个星号或下划线。要斜体突出内容的中间部分，请在内容前后各添加一个星号，中间不要带空格。
语法:

1
*今天天气真好*

今天天气真好

粗体和斜体

要同时用粗体和斜体突出显示文本，请在单词或短语的前后各添加三个星号或下划线。要加粗并用斜体显示单词或短语的中间部分，请在要突出显示的部分前后各添加三个星号，中间不要带空格。
语法

1
你可***真***好看

你可真好看

斜体和粗体

Markdown 应用程序在处理内容中间添加的下划线上并不一致。为了实现兼容性，请使用星号将内容的中间部分加粗并以斜体显示，以示重要。

引用语法

要创建块引用，请在段落前添加一个>符号。
语法

1
>这是引用效果

预览

这是引用效果

多个段落引用

块引用可以包含多个段落。为段落之间的空白行添加一个>符号。

语法：

1
2
3
>多个段落的引用效果就是这样的
>
>明白了吗？

预览

多个段落的引用效果就是这样的

明白了吗？

嵌套块引用

块引用可以嵌套。在要嵌套的段落前添加一个>>符号。

语法

1
2
>这是效果
>>这是效果的效果

预览

这是效果

这是效果的效果

带有其他元素的引用

块引用可以包含其他 Markdown 格式的元素。并非所有元素都可以使用，你需要进行实验以查看哪些元素有效。

语法

1
2
3
4
5
6
> #### 加粗引用
>
> - 小标题1
> - 小标题2
>
>  *斜体*加**加粗**.

预览

加粗引用

  • 小标题1
  • 小标题2

斜体加加粗.

列表语法

有序列表

要创建有序列表，请在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列，但是列表应当以数字 1 起始。
语法

1
2
3
1.这是第一点
2.这是第二点
3.这是第三点

预览
1.这是第一点
2.这是第二点
3.这是第三点

代码语法

要将单词或短语表示为代码，请将其包裹在反引号 (`) 中。

转义反引号

如果你要表示为代码的单词或短语中包含一个或多个反引号，则可以通过将单词或短语包裹在双反引号(``)中。
##代码块
要创建代码块，请将代码块的每一行缩进至少四个空格或一个制表符。

分割线语法

要创建分隔线，请在单独一行上使用三个或多个星号 (***)、破折号 (—) 或下划线 (___) ，并且不能包含其他内容。
为了兼容性，请在分隔线的前后均添加空白行。
语法

1
2
3
***
---
___

预览

链接语法

链接文本放在中括号内，链接地址放在后面的括号中，链接title可选。

超链接Markdown语法代码：

1
[超链接显示名](超链接地址 "超链接title")

给链接增加 Title

链接title是当鼠标悬停在链接上时会出现的文字，这个title是可选的，它放在圆括号中链接地址后面，跟链接地址之间以空格分隔。
语法

1
[李鑫的博客](https://eelx.cn/ "点击打开李鑫的博客")

预览
李鑫的博客

网址和Email地址

使用尖括号可以很方便地把URL或者email地址变成可点击的链接。
语法

1
2
<https://eelx.cn>
<[email protected]>

预览
https://eelx.cn
lixin@lixin.ee

带格式化的链接

强调 链接, 在链接语法前后增加星号。 要将链接表示为代码，请在方括号中添加反引号。
语法

1
2
3
这是记录我跟阿豆在一起的天数 **[李鑫&阿豆](https://adou.lixin.ee)**.
这个也是记录我跟阿豆在一起的天数 *[李鑫&阿豆](https://adou.lixin.ee)*.
这个也是记录我跟阿豆在一起的天数 [`李鑫&阿豆`](https://adou.lixin.ee).

预览
这是记录我跟阿豆在一起的天数 李鑫&阿豆.
这个也是记录我跟阿豆在一起的天数 李鑫&阿豆.
这个也是记录我跟阿豆在一起的天数 李鑫&阿豆.

引用类型链接

引用样式链接是一种特殊的链接，它使URL在Markdown中更易于显示和阅读。参考样式链接分为两部分：与文本保持内联的部分以及存储在文件中其他位置的部分，以使文本易于阅读。

链接的第一部分格式

引用类型的链接的第一部分使用两组括号进行格式设置。第一组方括号包围应显示为链接的文本。第二组括号显示了一个标签，该标签用于指向您存储在文档其他位置的链接。

尽管不是必需的，可以在第一组和第二组括号之间包含一个空格。第二组括号中的标签不区分大小写，可以包含字母，数字，空格或标点符号。

以下示例格式对于链接的第一部分效果相同：

[hobbit-hole][1]
[hobbit-hole] [1]

链接的第二部分格式

引用类型链接的第二部分使用以下属性设置格式：

放在括号中的标签，其后紧跟一个冒号和至少一个空格（例如[label]:）。
链接的URL，可以选择将其括在尖括号中。
链接的可选标题，可以将其括在双引号，单引号或括号中。
以下示例格式对于链接的第二部分效果相同：

1
2
3
4
5
6
7
[1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle
[1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle "Hobbit lifestyles"
[1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle 'Hobbit lifestyles'
[1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle (Hobbit lifestyles)
[1]: <https://en.wikipedia.org/wiki/Hobbit#Lifestyle> "Hobbit lifestyles"
[1]: <https://en.wikipedia.org/wiki/Hobbit#Lifestyle> 'Hobbit lifestyles'
[1]: <https://en.wikipedia.org/wiki/Hobbit#Lifestyle> (Hobbit lifestyles)

可以将链接的第二部分放在Markdown文档中的任何位置。有些人将它们放在出现的段落之后，有些人则将它们放在文档的末尾（例如尾注或脚注）。

图片语法

要添加图像，请使用感叹号 (!), 然后在方括号增加替代文本，图片链接放在圆括号里，括号里的链接后可以增加一个可选的图片标题文本。
语法

1
![随机图片](https://picsum.photos/1920/1080 "鼠标放上去的文字")

预览
随机图片

链接图片

给图片增加链接，请将图像的Markdown 括在方括号中，然后将链接添加在圆括号中。
语法

1
[![随机图片](https://picsum.photos/1920/1080 "访问李鑫的博客")](https://eelx.cn)

预览
随机图片

转义字符语法

要显示原本用于格式化 Markdown 文档的字符，请在字符前面添加反斜杠字符 \ 。
语法

1
\* 这很重要

预览
* 这很重要

可做转义的字符

符号 名字
\ 反斜杠
` 反引号
* *号
_ 下划线
{ } 大括号
[ ] 括号
( ) 括弧
# #号
+ 加号
- 减号
. 点
! 感叹号

特殊字符自动转义

在HTML文件中，有两个字符需要特殊处理：<和&。<符号用于起始标签&符号则用于标记HTML实体，如果你只是想要使用这些符号，你必须要使用实体的形式，像是&lt;和&amp;。
&符号其实很容易让写作网页文件的人感到困扰，如果你要打「AT&T」，你必须要写成「AT&amp;T」，还得转换网址内的&符号，如果你要链接到：

1
http://images.google.com/images?num=30&q=larry+bird

你必须要把网址转成：

1
http://images.google.com/images?num=30&amp;q=larry+bird

才能放到链接标签的href属性里。不用说也知道这很容易忘记，这也可能是HTML标准检查所检查到的错误中，数量最多的。
Markdown 允许你直接使用这些符号，它帮你自动转义字符。如果你使用&符号的作为HTML实体的一部分，那么它不会被转换，而在其它情况下，它则会被转换成&amp;。所以你如果要在文件中插入一个著作权的符号，你可以这样写：

1
&copy;

Markdown将不会对这段文字做修改，但是如果你这样写：

1
AT&T

Markdown就会将它转为：

1
AT&amp;T

类似的状况也会发生在<符号上，因为Markdown支持行内HTML，如果你使用<符号作为HTML标签的分隔符，那Markdown也不会对它做任何转换，但是如果你是写：

1
4 < 5

Markdown 将会把它转换为：

1
4 &lt; 5

需要特别注意的是，在 Markdown 的块级元素和内联元素中，<和&两个符号都会被自动转换成HTML实体，这项特性让你可以很容易地用 Markdown写HTML。（在 HTML 语法中，你要手动把所有的<和&都转换为HTML实体。）

内嵌HTML标签

对于Markdown涵盖范围之外的标签，都可以直接在文件里面用HTML本身。如需使用HTML，不需要额外标注这是HTML或是Markdown，只需HTML标签添加到Markdown文本中即可。

行级內联标签

HTML的行级內联标签如<span>、<cite>、<del>不受限制，可以在Markdown的段落、列表或是标题里任意使用。依照个人习惯，甚至可以不用Markdown格式，而采用HTML标签来格式化。例如：如果比较喜欢HTML的<a>或<img>标签，可以直接使用这些标签，而不用Markdown提供的链接或是图片语法。当你需要更改元素的属性时（例如为文本指定颜色或更改图像的宽度），使用HTML标签更方便些。

HTML行级內联标签和区块标签不同，在內联标签的范围内，Markdown的语法是可以解析的。
语法

1
This **word** is bold. This <em>word</em> is italic.

预览
This word is bold. This word is italic.

区块标签

区块元素──比如<div>、<table>、<pre>、<p> 等标签，必须在前后加上空行，以便于内容区分。而且这些元素的开始与结尾标签，不可以用 tab 或是空白来缩进。Markdown会自动识别这区块元素，避免在区块标签前后加上没有必要的<p>标签。

例如，在Markdown文件里加上一段HTML表格：

1
2
3
4
5
6
7
8
9
This is a regular paragraph.

<table>
    <tr>
        <td>Foo</td>
    </tr>
</table>

This is another regular paragraph.

请注意，Markdown语法在HTML区块标签中将不会被进行处理。例如，你无法在HTML区块内使用Markdown形式的*强调*。

HTML用法最佳实践

出于安全原因，并非所有Markdown应用程序都支持在Markdown文档中添加HTML。如有疑问，请查看相应Markdown应用程序的手册。某些应用程序只支持HTML标签的子集。

对于HTML的块级元素<div>、<table>、<pre>和<p>，请在其前后使用空行（blank lines）与其它内容进行分隔。尽量不要使用制表符（tabs）或空格（spaces）对HTML标签做缩进，否则将影响格式。

在HTML块级标签内不能使用Markdown语法。例如<p>italic and **bold**</p>将不起作用。

扩展语法

删除线

您可以通过在单词中心放置一条水平线来删除单词。结果看起来像这样。此功能使您可以指示某些单词是一个错误，要从文档中删除。若要删除单词，请在单词前后使用两个波浪号~~。
语法

1
~~世界是平坦的。~~ 我们现在知道世界是圆的。

预览
世界是平坦的。 我们现在知道世界是圆的。

任务列表语法

任务列表使您可以创建带有复选框的项目列表。在支持任务列表的Markdown应用程序中，复选框将显示在内容旁边。要创建任务列表，请在任务列表项之前添加破折号-和方括号[ ]，并在[ ]前面加上空格。要选择一个复选框，请在方括号[x]之间添加 x 。

1
2
3
- [x] 带女朋友见家长
- [x] 带女朋友去玩
- [ ] 给女朋友买个包
  • 带女朋友见家长
  • 带女朋友去玩
  • 给女朋友买个包

自动网址链接

许多Markdown处理器会自动将URL转换为链接。这意味着如果您输入https://eelx.cn/ ，即使您未使用方括号，您的Markdown处理器也会自动将其转换为链接。

1
https://eelx.cn/

呈现的输出如下所示：
https://eelx.cn/

禁用自动URL链接

如果您不希望自动链接URL，则可以通过将URL表示为带反引号的代码来删除该链接。

1
`https://eelx.cn/`

呈现的输出如下所示：
https://eelx.cn/

使用Emoji表情

有两种方法可以将表情符号添加到Markdown文件中：将表情符号复制并粘贴到Markdown格式的文本中，或者键入emoji shortcodes。

复制和粘贴表情符号

在大多数情况下，您可以简单地从Emojipedia等来源复制表情符号并将其粘贴到文档中。许多Markdown应用程序会自动以Markdown格式的文本显示表情符号。从Markdown应用程序导出的HTML和PDF文件应显示表情符号。

Tip: 如果您使用的是静态网站生成器，请确保将HTML页面编码为UTF-8。

使用表情符号简码

一些Markdown应用程序允许您通过键入表情符号短代码来插入表情符号。这些以冒号开头和结尾，并包含表情符号的名称。

1
2
去露营了！ :tent: 很快回来。
真好笑！ :joy:

呈现的输出如下所示：
去露营了！⛺很快回来。
真好笑！😂

表格

1
2
3
4
|  表头   | 表头  |
|  ----  | ----  |
| 单元格  | 单元格 |
| 单元格  | 单元格 |
表头 表头
单元格 单元格
单元格 单元格 
1
2
3
4
| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
左对齐 右对齐 居中对齐
单元格 单元格 单元格
单元格 单元格 单元格

我的第一篇md

这是我用MD写的第一篇文章，留给自己备用。
跳转顶部

李鑫微信公众号李鑫X

土木狗。