基本语法

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

点击链接可查看Markdown官方文档:

Markdown官方文档

点击链接可使用在线Markdown编辑器:

在线markdown编辑器

标题语法

要创建标题,在单词或短语前面添加井号 (#) 。# 的数量代表了标题的级别,最多可以添加六级标题。

注意#和后面的内容之间需要有一个空格。

例:添加三个 #表示创建一个三级标题

1
### 三级标题

段落语法

创建段落时,需要使用一个空白行进行分隔。

例:书写I have a dream的前三段

1
2
3
4
5
I am happy to join with you today in what will go down in history as the greatest demonstration for freedom in the history of our nation.  

Five score years ago, a great American, in whose symbolic shadow we stand today, signed the Emancipation Proclamation. This momentous decree came as a great beacon light of hope to millions of Negro slaves who had been seared in the flames of withering injustice. It came as a joyous daybreak to end the long night of bad captivity.

But one hundred years later, the Negro still is not free. One hundred years later, the life of the Negro is still sadly crippled by the manacles of segregation and the chains of discrimination. One hundred years later, the Negro lives on a lonely island of poverty in the midst of a vast ocean of material prosperity. One hundred years later, the Negro is still languished in the corners of American society and finds himself an exile in his own land. And so we've come here today to dramatize a shameful condition.

结果展示:

I am happy to join with you today in what will go down in history as the greatest demonstration for freedom in the history of our nation.

Five score years ago, a great American, in whose symbolic shadow we stand today, signed the Emancipation Proclamation. This momentous decree came as a great beacon light of hope to millions of Negro slaves who had been seared in the flames of withering injustice. It came as a joyous daybreak to end the long night of bad captivity.

But one hundred years later, the Negro still is not free. One hundred years later, the life of the Negro is still sadly crippled by the manacles of segregation and the chains of discrimination. One hundred years later, the Negro lives on a lonely island of poverty in the midst of a vast ocean of material prosperity. One hundred years later, the Negro is still languished in the corners of American society and finds himself an exile in his own land. And so we’ve come here today to dramatize a shameful condition.

换行语法

在一行的末尾添加两个或多个空格,然后按回车键,即可创建一个换行。

强调语法

粗体(Bold)

通过将文本设置为粗体或斜体来强调其重要性。

在文本前后各加两个星号或者下划线可实现粗体效果。

例:加粗文本“好耶!”

1
2
**好耶!**  
__好耶!__

结果展示:

好耶!

好耶!

斜体(Italic)

在文本前后各加一个星号或者下划线可实现斜体效果。

例:倾斜文本“好耶!”

1
2
*好耶!*  
_好耶!_

结果展示:

好耶!

好耶!

引用语法

块引用

要创建块引用,需要在段落前添加一个 > 符号。

例:引用“No one breather who is worthier.”

1
> No one breather who is worthier.

结果展示:

No one breather who is worthier.

多个段落的块引用

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

例:引用I have a dream的前两段

1
2
3
> I am happy to join with you today in what will go down in history as the greatest demonstration for freedom in the history of our nation.  
>
> Five score years ago, a great American, in whose symbolic shadow we stand today, signed the Emancipation Proclamation. This momentous decree came as a great beacon light of hope to millions of Negro slaves who had been seared in the flames of withering injustice. It came as a joyous daybreak to end the long night of bad captivity.

结果展示:

I am happy to join with you today in what will go down in history as the greatest demonstration for freedom in the history of our nation.

Five score years ago, a great American, in whose symbolic shadow we stand today, signed the Emancipation Proclamation. This momentous decree came as a great beacon light of hope to millions of Negro slaves who had been seared in the flames of withering injustice. It came as a joyous daybreak to end the long night of bad captivity.

嵌套块引用

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

例:引用I have a dream的前两段,其中嵌套第二段

1
2
3
> I am happy to join with you today in what will go down in history as the greatest demonstration for freedom in the history of our nation.  
>
>> Five score years ago, a great American, in whose symbolic shadow we stand today, signed the Emancipation Proclamation. This momentous decree came as a great beacon light of hope to millions of Negro slaves who had been seared in the flames of withering injustice. It came as a joyous daybreak to end the long night of bad captivity.

结果展示:

I am happy to join with you today in what will go down in history as the greatest demonstration for freedom in the history of our nation.

Five score years ago, a great American, in whose symbolic shadow we stand today, signed the Emancipation Proclamation. This momentous decree came as a great beacon light of hope to millions of Negro slaves who had been seared in the flames of withering injustice. It came as a joyous daybreak to end the long night of bad captivity.

带有其他元素的块引用

块引用可以包含其他 Markdown 格式的元素,但是并非所有元素都可以使用。

列表语法

可以将多个条目组织成有序或无序列表。

有序列表

创建有序列表,需要在列表项前添加数字并紧跟一个英文句点,记得加一个空格。数字不必按照数学顺序排列,但是列表是从数字1开始起始的(如果起始数字是5,则从5开始编号)。

例:创建一个有序列表,内容是星期一到星期五

第一种写法

1
2
3
4
5
1. 星期一
2. 星期二
3. 星期三
4. 星期四
5. 星期五

第二种写法

1
2
3
4
5
1. 星期一
1. 星期二
1. 星期三
1. 星期四
1. 星期五

第三种写法

1
2
3
4
5
1. 星期一
4. 星期二
1. 星期三
5. 星期四
9. 星期五

结果展示:

  1. 星期一
  2. 星期二
  3. 星期三
  4. 星期四
  5. 星期五

嵌套有序列表

如果想制作一个嵌套的有序列表,可以在列表的某一项的下一行进行缩进,然后再创建一个有序列表。

例:创建一个有序列表,内容是星期一到星期五,从3号开始标号,星期三中嵌套星期六和星期日

1
2
3
4
5
6
7
3. 星期一
1. 星期二
4. 星期三
1. 星期六
5. 星期日
9. 星期四
2. 星期五

结果展示:

  1. 星期一
  2. 星期二
  3. 星期三
    1. 星期六
    2. 星期日
  4. 星期四
  5. 星期五

无序列表

创建无序列表,需要在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+) ,接着加一个空格。缩进一个或多个列表项可创建嵌套列表。

例:创建一个无序列表,内容是星期一到星期五

1
2
3
4
5
- 星期一
- 星期二
- 星期三
- 星期四
- 星期五

结果展示:

  • 星期一
  • 星期二
  • 星期三
  • 星期四
  • 星期五

代码语法

代码单词

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

例:将Bigglesworth表示为代码

1
`Bigglesworth`

结果展示:

Bigglesworth

转义反引号

如果要表示为代码的单词或短语中包含一个或多个反引号,则可以通过将单词或短语包裹在双反引号(``)中。

例:

1
`` `code` ``

结果展示:

`code`

代码块

创建代码块,需要将代码块的每一行缩进至少四个空格或一个制表符。

例:

1
2
3
4
5
6
7
    <html>

        <head>

        </head>

    <html>

分隔线语法

分隔线语法需要在单独一行上使用三个或多个星号 (***)、破折号 (---) 或下划线 (___) ,并且不能包含其他内容。

例:

1
2
3
***
---
___

结果展示:




链接语法

Title链接

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

title是鼠标悬停时显示的文字

超链接Markdown语法代码:[超链接显示名](超链接地址 "超链接title")

例:制作一个到该博客的超链接

1
[Bigglesworth](https://big-worth.github.io/ "比格沃斯的博客")

结果展示:

Bigglesworth

网址和Email地址

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

例:将Bigglesworth7@163.com邮箱制作成链接

1
<Bigglesworth7@163.com>

结果展示:

Bigglesworth7@163.com

带格式化的链接

可以使用强调语法来修饰链接

图片语法

本地图片

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

title是鼠标悬停时显示的文字

插入图片Markdown语法代码:![图片alt](图片链接 "图片title")

例:插入一张文件路径为E:/Workspaces/hexo/themes/butterfly/source/img/index_img/index_img.jpg名字为壁纸的图片

1
![壁纸](E:/Workspaces/hexo/themes/butterfly/source/img/index_img/index_img.jpg "海琴烟")

结果展示:

壁纸

链接图片

将图像的Markdown 括在方括号中,然后将链接添加在圆括号中。

例:插入图片E:/Workspaces/hexo/themes/butterfly/source/img/index_img/archive_img.jpg并链接到该博客

1
[![链接](E:/Workspaces/hexo/themes/butterfly/source/img/index_img/archive_img.jpg)](https://big-worth.github.io/) 

结果展示:

链接

转义字符语法

要显示原本用于格式化的字符,需要在字符前面添加反斜杠字符\

例:书写*

1
\*

结果展示:

*