MarkDown语法文档

Markdown语法01

Markdown是一种纯文本格式的标记语言。通过简单的标记语法，它可以使普通文本内容具有一定的格式。相比WYSIWYG编辑器优点： 1、因为是纯文本，所以只要支持Markdown的地方都能获得一样的编辑效果，可以让作者摆脱排版的困扰，专心写作。 2、操作简单。比如:WYSIWYG编辑时标记个标题，先选中内容，再点击导航栏的标题按钮，选择几级标题。要三个步骤。而Markdown只需要在标题内容前加#即可缺点： 1、需要记一些语法（当然，是很简单。五分钟学会）。 2、有些平台不支持Markdown编辑模式。还好，aki文档系统是支持Markdown编辑模式的。

一、标题

在想要设置为标题的文字前面加#来表示一个#是一级标题，二个#是二级标题，以此类推。支持六级标题。注：标准语法一般在#后跟个空格再写文字，貌似简书不加空格也行。示例：

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

效果如下：

这是一级标题
这是二级标题
这是三级标题
这是四级标题
这是五级标题
这是六级标题

二、字体

.** 加粗**

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

. 斜体

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

.斜体加粗

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

.删除线

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

示例：

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

效果如下：

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

三、引用

在引用的文字前加>即可。引用也可以嵌套，如加两个>>三个>>> n个... 貌似可以一直加下去，但没神马卵用示例：

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

效果如下：

这是引用的内容

四、分割线

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

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

效果如下：可以看到，显示效果是一样的。

五、图片

语法： ![图片alt](图片地址 ''图片title'') 图片alt就是显示在图片下面的文字，相当于对图片内容的解释。 图片title是图片的标题，当鼠标移到图片上时显示的内容。title可加可不加

示例：

![blockchain](http://cnaki.top/qrcode?id=2 "文档二维码")

效果如下： blockchain

blockchain

上传本地图片直接点击导航栏的图片标志，选择图片即可 markdown格式追求的是简单、多平台统一。那么图片的存储就是一个问题，需要用图床，提供统一的外链，这样就不用在不同的平台去处理图片的问题了。才能做到书写一次，各处使用。关于图床的选择我写了一篇文章，对网上存在的各种方法做了总结，需要的朋友可以看看。markdown图床

六、超链接

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

示例：

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

效果如下：百度

注：Markdown本身语法不支持链接在新页面中打开，貌似简书做了处理，是可以的。别的平台可能就不行了，如果想要在新页面中打开的话可以用html语言的a标签代替。 <a href="超链接地址" target="_blank">超链接名</a>

示例

<a href="https://www.jianshu.com/u/1f5ac0cf6a8b" target="_blank">简书</a>

七、列表

无序列表

语法：无序列表用 - + * 任何一种都可以

- 列表内容
+ 列表内容
* 列表内容

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

效果如下：

列表内容

列表内容

列表内容

有序列表

语法：数字加点 1. 列表内容 2. 列表内容 3. 列表内容 注意：序号跟内容之间要有空格

效果如下：

列表内容
列表内容
列表内容

列表嵌套

上一级和下一级之间敲三个空格即可

一级无序列表内容
- 二级无序列表内容
- 二级无序列表内容
- 二级无序列表内容

一级无序列表内容
1. 二级有序列表内容
2. 二级有序列表内容
3. 二级有序列表内容

一级有序列表内容

二级无序列表内容
二级无序列表内容
二级无序列表内容

一级有序列表内容
二级有序列表内容
二级有序列表内容
二级有序列表内容

八、表格

语法： 表头|表头|表头 ---|:--:|---: 内容|内容|内容 内容|内容|内容

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

示例：

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

效果如下：

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

九、代码

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

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

注：为了防止转译，前后三个反引号处加了小括号，实际是没有的。这里只是用来演示，实际中去掉两边小括号即可。

示例：单行代码


`create database hero;`

代码块

(```)
    function fun(){
         echo "这是一句非常牛逼的代码";
    }
    fun();
(```)

效果如下：

单行代码
create database hero;
代码块
function fun(){
  echo "这是一句非常牛逼的代码";
}
fun();

十、流程图

flow
st=>start: 开始
op=>operation: My Operation
cond=>condition: Yes or No?
e=>end
st->op->cond
cond(yes)->e
cond(no)->op

十一、字体居中

示例：

`<H1 align="center">   [菜鸟工具](https://c.runoob.com/#pic_center)  </H1>`
 `<center>aki 文档</center>`

效果如下：

Aki

[菜鸟工具](https://c.runoob.com/ "菜鸟工具")

aki 文档

Markdown语法02

markdown是一种轻量级标记语言，具有纯文本格式语法。它由John Gruber 与Aaron Swartz在2004年合作创建。其目标是让人们“使用易于阅读且易于编写的纯文本格式进行编写，可选将其转换为结构上有效的XHTML或HTML”。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。

一、标题

Markdown 支持两种标题的语法，类 Setext 和类 atx 形式。类 Setext 形式是用底线的形式，利用 = （最高阶标题）和 - （第二阶标题)。类 Atx 形式则是在行首插入 1 到 6 个 # ，对应到标题 1 到 6 阶。

1、用#标记

在标题开头加上1~6个#，依次代表一至六级标题。

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

显示效果如下:

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

注意：#与标题之间最好空有一格，查资料时有博主表示在Visual Studio Code中,#与标题需要空一格,才能渲染为标题,但在简书的markdown编辑器中,#与标题不需要空一格,就能表示标题。

2、用=和-标记

在标题底下加上任意个=代表一级标题，-代表二级标题。这个用法貌似不常用，也比较难用，在我手上好像还不管用，以下纪录一次失败的尝试，不懂怎么回事。

#空一行
主标题
===
副标题
---
一级标题
=========
二级标题
----------

显示效果如下:

主标题

副标题

一级标题

二级标题

opps！好像并没有什么卵用...这个主和副标题怎么没变化呢，-这里明摆着显示成了分割线？
注意：一级标题/主标题前方必须留有空行!否则二级标题就默认成为了分隔线，正常效果如下：

主标题

副标题

一级标题

二级标题

既然说到分割线，这里插播一条分割线。

3、分割线

在markdown语法中,一行连用三个或者三个以上的星号,减号,或者下划线,就可以表示分割线。可以在一行用3个以上的 * - _来建立一条分割线，行内除了空格不能有其他东西。例如:

*** 这里是分割线  
--- 这里也是分割线  
__ 这里还是分割线

显示效果如下：

据说三条线效果是不同的，按顺序是很明显，不明显，一般。简书的预览效果里我看着三分割线好像也没多大差别。

二、换行

方法1：连敲2个以上空格+enter键；

方法2：利用html语法，<br>。

三、缩进/空格

由于平时中文的排版习惯，首行通常缩进两字符什么的，所以顺便也了解以下操作,在markdown里这个还稍微有点麻烦，不是敲两下空格键就搞定的。这里需要借用html方面的空格实体。首先明确1个汉字=2个空格大小

1、一个空格大小的表示`&ensp; &#8194;`两种用法显示效果一致。
2、两个空格大小的表示`&emsp; &#8195;`两种用法显示效果一致。
3、不换行空格的表示`&nbsp; &#160;`也是占一个空格的宽度大小。

四、正文字体

1、粗/斜/删除线/下划线

普通的正文不需要加任何标签，直接打字就OK。但要获得加粗、斜体、删除线等效果，需要在文字左右两侧添加相应的符号。连续两个*或_表示加粗，一个*或_表示斜体，~~表示删除。那么加粗斜体怎么表示呢？没错，就是连续三个*或_。

**加粗**，__加粗__  
 *斜体*，_斜体_
***加粗斜体***
~~删除~~

显示效果如下：

加粗，加粗
斜体，斜体 加粗斜体 ~~删除~~

2、反转义符号

/（反斜杠），使其后的符号成为普通符号，不加特效。

\\ 反斜杠

\` 反引号

\* 星号

\_ 下划线

\{\} 大括号

\[\] 中括号

\(\) 小括号

\#井号

\+ 加号

\- 减号

\. 英文句号

\! 感叹号

显示效果如下： \ 反斜线 ` 反引号 * 星号 _ 底线 {} 花括号 [] 方括号 () 括弧 # 井字号 + 加号 - 减号 . 英文句点 ! 惊叹号

3、字体、字号、颜色

指定字体类型： <font face="黑体">我是黑体字</font>
指定字体大小： <font size=12>我是12号字</font>
指定字体颜色：<font color=#0099ff>我是蓝色字</font> #0099ff 为颜色的16进制代码
指定字体颜色、字号、字体类型<font color=#0099ff size=12 face="黑体">黑体</font>

显示效果：

我是黑体字

这里就附上其他编辑器的效果图吧：

指定字体类型：我是黑体字

指定字体大小：我是12号字

指定字体颜色：我是蓝色字 #0099ff 为颜色的16进制代码

指定字体颜色、字号、字体类型黑体

五、引用

如果一段的内容是引用别人的话，在被引用的文本前加上符号>。

> 一个人的命运啊，当然要靠自我奋斗，但是也要考虑到历史的进程。

显示效果如下：

一个人的命运啊，当然要靠自我奋斗，但是也要考虑到历史的进程。

Markdown 标记区块引用的方法是在行的最前面加> ，也可以只在整个段落的第一行最前面加上>，区块引用内部可以嵌套，只要根据层次加上不同数量的 >即可，引用的区块内也可以使用其他的 Markdown 语法，包括标题、列表、代码区块等。

>还记得一句教诲吗
> >一个人的命运啊，当然要靠自我奋斗，但是也要考虑到历史的进程。
>>>谁说不是呢

显示效果如下：

还记得一句教诲吗

一个人的命运啊，当然要靠自我奋斗，但是也要考虑到历史的进程。

谁说不是呢

再来试一波儿~~~

MarkDown语法文档

Markdown语法01

一、标题

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题

这是六级标题

二、字体

三、引用

四、分割线

效果如下： 可以看到，显示效果是一样的。

五、图片

六、超链接

七、列表

无序列表

有序列表

列表嵌套

上一级和下一级之间敲三个空格即可

八、表格

九、代码

十、流程图

十一、字体居中

[菜鸟工具](https://c.runoob.com/ "菜鸟工具")

Markdown语法02

一、标题

1、用#标记

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

2、用=和-标记

主标题

副标题

一级标题

二级标题

主标题

副标题

一级标题

二级标题

3、分割线

二、换行

三、缩进/空格

四、正文字体

1、粗/斜/删除线/下划线

2、反转义符号

3、字体、字号、颜色

五、引用

效果如下：可以看到，显示效果是一样的。