第一篇博文: Markdown语法手册

Markdown语法手册

1. 格式控制

1.1 粗体/斜体

代码

*斜体*或_斜体_
**粗体**  
***加粗斜体***

显示效果
斜体斜体
粗体
加粗斜体

1.2 字体大小

代码

<font size=4>我是4号字</font>
<small>字体变小</small>
<big>字体变大</big>
<font face="黑体">我是黑体字</font>
<font color=#0099ff size=12 face="黑体">黑体</font>
<font color=#00ffff size=3>null</font>
<font color=gray size=5>gray</font>

显示效果
<font size=4>我是4号字</font>
<small>字体变小</small>
<big>字体变大</big>
<font face="黑体">我是黑体字</font>
<font color=#0099ff size=12 face="黑体">黑体</font>
<font color=#00ffff size=3>null</font>
<font color=gray size=5>gray</font>

2. 标题(#后请加空格)

代码

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题(最多六级)

显示效果

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题(最多六级)

3. 列表

3.1 有序列表

语法说明
有序列表需要在文字前加1.2.3.

代码

1. 有序列表项1
2. 有序列表项2
3. 有序列表项3

显示效果

  1. 有序列表项1
  2. 有序列表项2
  3. 有序列表项3

3.2 无序列表

语法说明
无序列表需要在文字前加-*

代码1

* 无序列表项1
* 无序列表项2
* 无序列表项3

显示效果1

  • 无序列表项1
  • 无序列表项2
  • 无序列表项3

代码2

- 无序列表项1
- 无序列表项2
- 无序列表项3

显示效果2

  • 无序列表项1
  • 无序列表项2
  • 无序列表项3

3.3 列表缩进

语法说明
在每项前加*+tab

代码

*   轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。 软泥上的青荇, 油油的在水底招摇; 在康河的柔波里, 我甘心做一条水草!
那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。
寻梦?撑一支长篙, 向青草更青处漫溯; 满载一船星辉, 在星辉斑斓里放歌。但我不能放歌, 悄悄是别离的笙箫; 夏虫也为我沉默, 沉默是今晚的康桥!
*   悄悄的我走了,正如我悄悄的来;我挥一挥衣袖,不带走一片云彩。

显示效果

  • 轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。 软泥上的青荇, 油油的在水底招摇; 在康河的柔波里, 我甘心做一条水草!
    那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。
    寻梦?撑一支长篙, 向青草更青处漫溯; 满载一船星辉, 在星辉斑斓里放歌。但我不能放歌, 悄悄是别离的笙箫; 夏虫也为我沉默, 沉默是今晚的康桥!
  • 悄悄的我走了,正如我悄悄的来;我挥一挥衣袖,不带走一片云彩。

3.4 特殊情况

错误代码

I love 
1986. What a great year!

错误结果
I love

  1. What a great year!

正确代码

I love 
1986\. What a great year!

正确结果
I love
1986. What a great year!

4. 引用

语法说明
需要在文本前添加>即可
注意:对于多端文字,可以只在段首添加>

代码

> 这是一个有两段文字的引用,
 无意义的占行文字1.
 无意义的占行文字2.
 
>无意义的占行文字3.
 无意义的占行文字4.

显示效果

这是一个有两段文字的引用,
无意义的占行文字1.
无意义的占行文字2.

无意义的占行文字3.
无意义的占行文字4.

4.1 引用的多层嵌套

代码

>>> 请问 Markdown 怎么用? - 小白

>> 自己看教程! - 愤青

> 教程在哪? - 小白

显示效果

请问 Markdown 怎么用? - 小白

自己看教程! - 愤青

教程在哪? - 小白

4.2 引用其他要素

引用区块中也可以使用其他Markdown语法。
代码

>1.   这是第一行列表项。
2.   这是第二行列表项。
    
>给出一些例子代码:
`return shell_exec("echo $input | $markdown_script");`

显示效果

  1. 这是第一行列表项。
  1. 这是第二行列表项。

给出一些例子代码:
return shell_exec("echo $input | $markdown_script");

5. 超链接 {#section 5}

Markdown超链接有两种形式:行内式和参考式。其中,行内式使用较多。

5.1 行内式

语法说明
[]中写链接字,()中写链接地址,()中的""部分记录链接的title属性(鼠标放置时显示的字段)。
形式为[链接文字](链接地址 "链接标题"),其中,链接地址与链接标题之间要有一个空格。

代码

欢迎来到[pdd直播间](https://www.panda.tv/6666)

欢迎来到[pdd直播间](https://www.panda.tv/6666 "pdd直播间地址")

显示效果

欢迎来到pdd直播间

欢迎来到pdd直播间

5.2 参考式

参考式通常使用于学术论文或者某条超链接被多次使用的场合。

语法说明
参考式超链接分为两部分:
文中:[链接文字][链接标记]
任何位置(通常是文末): [链接标记]:链接地址 "链接标题"

如果使用链接文字作为链接标记,书写方式如下:
文中: [链接文字][]
任何位置: [链接文字]:链接地址

代码

娱乐时会选择去[pdd直播间][1]看直播放松;学习时会选择去[我的博客][2]静心钻研; 遇到问题会查询[百度][]; 本文的参考博客来自[梵居闹市的博客]。
[1]: https://www.panda.tv/6666 "pdd直播间地址"
[2]: http://www.jianshu.com/users/11fbce2586e2/timeline "xuhaowxy的博客"
[3]: http://http://http://blog.leanote.com/post/freewalk/Markdown "梵居闹市"
[百度]: www.baidu.com "百度"

显示效果
娱乐时会选择去[pdd直播间][1]看直播放松;学习时会选择去[我的博客][2]静心钻研; 遇到问题会查询[百度][]; 本文的参考博客来自[梵居闹市的博客]。
[1]: https://www.panda.tv/6666 "pdd直播间地址"
[2]: http://www.jianshu.com/users/11fbce2586e2/timeline "xuhaowxy的博客"
[3]: http://http://http://blog.leanote.com/post/freewalk/Markdown "梵居闹市"
[百度]: www.baidu.com "百度"

5.3 自动链接

Markdown支持直接把网址或电子邮箱地址转化为超链接。

语法说明
<链接地址>,其中如果是网址,必须以http://开头
代码

我的邮箱地址<xuhaowxy@qq.com>,
我的博客是 <http://www.jianshu.com/users/11fbce2586e2/timeline> 

显示效果
我的邮箱地址xuhaowxy@qq.com
我的博客是 http://www.jianshu.com/users/11fbce2586e2/timeline

5.4 锚点

锚点即超链接的目标位置是本文的其他地方(比如目录),一般用于文内跳转。

语法说明
在跳转目标点添加{#标记}
在其他位置写上[链接文字](#标志)

代码
跳转到[第五章](#section 5)

显示效果
跳转到[第五章](#section 5)

6. 插入图片

插入图片的写法与超链接类似,也分为行内式和参考式两种。

6.1 行内式

语法说明
![](图片地址 "图片标题")
代码

错误图片:
![](图片地址 "图片标题")
美丽花儿:
![美丽花儿](http://ww2.sinaimg.cn/large/56d258bdjw1eugeubg8ujj21kw16odn6.jpg "美丽花儿")

显示效果
错误图片:


美丽花儿:
美丽花儿
美丽花儿

6.2 参考式

语法说明

在文档要插入图片的地方写![图片Alt][标记]
在文档的最后写上[标记]:图片地址 "Title"

代码

美丽花儿:
![美丽花儿][flower]
[flower]:http://ww2.sinaimg.cn/large/56d258bdjw1eugeubg8ujj21kw16odn6.jpg  "美丽花儿"

显示效果
美丽花儿:
![美丽花儿][flower]
[flower]:http://ww2.sinaimg.cn/large/56d258bdjw1eugeubg8ujj21kw16odn6.jpg "美丽花儿"

7. 注脚

语法说明
在需要添加注脚的文字后加上脚注名字[^注脚名字],称为加注。 然后在文本的任意位置(一般在最后)添加脚注,脚注前必须有对应的脚注名字。

注意:经测试注脚与注脚之间必须空一行,不然会失效。成功后会发现,即使你没有把注脚写在文末,经Markdown转换后,也会自动归类到文章的最后。

代码

使用 Markdown[^1]可以效率的书写文档, 直接转换成 HTML[^2], 你可以使用 Leanote[^Le] 编辑器进行书写。

[^1]:Markdown是一种纯文本标记语言

[^2]:HyperText Markup Language 超文本标记语言

[^Le]:开源笔记平台,支持Markdown和笔记直接发为博文

显示效果
使用 Markdown[1]可以效率的书写文档, 直接转换成 HTML[2], 你可以使用 Leanote[3] 编辑器进行书写。

8. 公式(写法同LaTeX)

8.1 行内公式

语法说明
$公式$

代码
质能方程为 $E=mc^2$

显示效果
质能方程为 $E=mc^2$

8.2 整行公式

语法说明
$$公式$$

代码

$$\sum_{i=1}^n a_i=0$$

$$f(x_1,x_x,\ldots,x_n) = x_1^2 + x_2^2 + \cdots + x_n^2 $$

$$\sum^{j-1}_{k=0}{\widehat{\gamma}_{kj} z_k}$$

显示效果
$$\sum_{i=1}^n a_i=0$$

$$f(x_1,x_x,\ldots,x_n) = x_1^2 + x_2^2 + \cdots + x_n^2 $$

$$\sum^{j-1}{k=0}{\widehat{\gamma}{kj} z_k}$$

9. 表格

语法说明

  1. 不管是哪种方式,第一行为表头,第二行分隔表头和主体部分,第三行开始每一行为一个表格行。
  2. 列于列之间用管道符|隔开。原生方式的表格每一行的两边也要有管道符。
  3. 第二行还可以为不同的列指定对齐方向。默认为左对齐,在-右边加上:就右对齐。

代码
简单方式写表格:

学号|姓名|分数
-|-|-
小明|男|75
小红|女|79
小陆|男|92

原生方式写表格:

|学号|姓名|分数|
|-|-|-|
|小明|男|75|
|小红|女|79|
|小陆|男|92|

为表格第二列指定方向:

产品|价格
-|-:
Leanote 高级账号|60元/年
Leanote 超级账号|120元/年

显示效果
简单方式写表格:

学号 姓名 分数
小明 75
小红 79
小陆 92

原生方式写表格:

学号 姓名 分数
小明 75
小红 79
小陆 92

为表格第二列指定方向:

产品 价格
Leanote 高级账号 60元/年
Leanote 超级账号 120元/年

10. 分隔符

语法说明
你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:

代码

* * *
***
*****

---------------------------------------

显示效果





11. 代码

对于程序员来说这个功能是必不可少的,插入程序代码的方式有两种,一种是利用缩进(Tab), 另一种是利用”`”符号(一般在ESC键下方)包裹代码。

语法说明

  1. 插入行内代码,即插入一个单词或者一句代码的情况,使用code这样的形式插入。
  2. 插入多行代码,可以使用缩进或者“code “,具体看示例。
    注意: 缩进式插入前方必须有空行

11.1 行内代码

代码

C语言里的函数 `scanf()` 怎么使用?

显示效果
C语言里的函数 scanf() 怎么使用?

11.2 多行代码(缩进)

代码


    #include <stdio.h>
    int main(void)
    {
        printf("Hello world\n");
    }

显示效果

#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}

11.3 多行代码(六个`包裹)

代码

```
#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}
```

显示效果

#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}

11.4 HTML源码

在代码区块里面, & 、 < 和 > 会自动转成 HTML 实体,这样的方式让你非常容易使用 Markdown 插入范例用的 HTML 原始码,只需要复制贴上,剩下的 Markdown 都会帮你处理,例如:

代码
第一个例子:

<div class="footer">
   © 2004 Foo Corporation
</div>

第二个例子:

<table>
    <tr>
        <th rowspan="2">值班人员</th>
        <th>星期一</th>
        <th>星期二</th>
        <th>星期三</th>
    </tr>
    <tr>
        <td>李强</td>
        <td>张明</td>
        <td>王平</td>
    </tr>
</table>

显示效果
第一个例子:
<div class="footer">
© 2004 Foo Corporation
</div>

第二个例子:
<table>
<tr>
<th rowspan="2">值班人员</th>
<th>星期一</th>
<th>星期二</th>
<th>星期三</th>
</tr>
<tr>
<td>李强</td>
<td>张明</td>
<td>王平</td>s
</tr>
</table>


  1. Markdown是一种纯文本标记语言

  2. HyperText Markup Language 超文本标记语言

  3. 开源笔记平台,支持Markdown和笔记直接发为博文

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,214评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,307评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,543评论 0 341
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,221评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,224评论 5 371
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,007评论 1 284
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,313评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,956评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,441评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,925评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,018评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,685评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,234评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,240评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,464评论 1 261
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,467评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,762评论 2 345

推荐阅读更多精彩内容

  • (Markdown语法没有一个统一的标准,不同的工具或平台采用的标准不一样,所以有些语法规则和功能是有差异的) 0...
    迟道阅读 56,680评论 4 69
  • << 访问 Wow!UbuntuNOTE: This is Simplelified Chinese Editio...
    Xiaosonl阅读 1,335评论 0 2
  • 声明: 这份文档派生(fork)于繁体中文版,在此基础上进行了繁体转简体工作,并进行了适当的润色。此文档用 Mar...
    Cellei阅读 4,665评论 0 21
  • Markdown: Syntax 概述 哲学 行内 HTML 特殊字符自动转换 区块元素 段落和换行 标题 区块引...
    未知代码阅读 7,504评论 6 50
  • 我一直以为公交车就是付费乘坐的规矩。最近因为携带小狗晶晶,被公交车司机拒绝我们乘坐,我才知道了公交车的规矩——拒载...
    爱阅沈阳阅读 570评论 0 0