Markdown常用基本语法

Markdown概述

Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,在 2004 由约翰·格鲁伯(英语:John Gruber)创建。Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。Markdown 编写的文档后缀为 .md, .markdown。Markdown 能被使用来撰写电子书,如:Gitbook。此外,当前许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。例如:GitHub、简书、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge等。

标题

在 Markdown 中,在文本前面加上 # 即为标题。同理,你还可以增加二级标题、三级标题、四级标题、五级标题和六级标题,总共六级,只需要增加 # 即可,标题字号相应降低。
注:# 和标题之间建议保留一个字符的空格,这是最标准的 Markdown 写法。

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

显示为:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

还有第二种表示标题的方式,使用=和-作为标记(三个以上),比如:

一级标题
===
二级标题
---

显示为:

一级标题

二级标题

列表

列表则是在文字前面加上-/+/*的一种就可以了,符号和后面内容间加个空格,此外列表也可以嵌套(在最前面加上三个空格即可),比如:

#无序列表
- 叙述一
   1. 分段一
   2. 分段二
   3. 分段三
+ 叙述二
* 叙述三
#有序列表
1. 叙述一
   + 分段一
2. 叙述二
3. 叙述三

显示为:

  • 叙述一
    1. 分段一
    2. 分段二
    3. 分段三
  • 叙述二
  • 叙述三
  1. 叙述一
    • 分段一
  2. 叙述二
  3. 叙述三

链接和图片

Markdown中插入链接只需要使用[标记文本](链接地址) "链接名称"即可,其中链接名称可省略比如:
[百度](www.baidu.com)
显示为:
百度
图片与链接类似,使用![图片名](图片链接地址 "图片名")即可,其中地址后的图片名指鼠标悬停时显示的图片名,可以省略。插入图片的地址需要图床,想了解的可以参考markdown图床。可以按下面的方式插入图片:
![贾宝玉和林黛玉](https://upload-images.jianshu.io/upload_images/16691637-74e1cd2cb25327df.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
显示为:

贾宝玉和林黛玉

此外可以使用变量代替链接的地址,转而在文档末尾变量赋值作为地址,比如

我们用变量baidu代替地址的值,[百度][baidu]
也可以用变量1代替谷歌的地址,[谷歌][1]
[baidu]: http://www.baidu.com/
[1]: http://www.google.com

简书貌似不支持显示,这里就不做演示了

引用

在文章中引用别人的文字或者想要特别显示的文字,就可以使用> 文字来插入引用,并且引用可以嵌套>> 文字,利用嵌套可以实现一定的格式控制。此外,可以在列表中使用引用(>前面要有四个空格)或者在引用中使用列表。比如:

>这世上本没有路,走的人多了便成了路
>
>静夜思
>>床前明月光,
>>疑是地上霜。
-列表中使用引用
    >前面需要有四个空格
    >前面需要有四个空格
>>
>引用中的列表
>1. 第一条
>2. 第二条
>- 列表内容
>
列表中带有引用
1. 第一条
    >前面要有四个空格
2. 第二条

显示为:

这世上本没有路,走的人多了便成了路

静夜思

床前明月光,
疑是地上霜。

引用中的列表

  1. 第一条
  2. 第二条
  • 列表内容

列表中带有引用

  1. 第一条

    前面要有四个空格

  2. 第二条

字体设置

在Markdown中设置字体也很简单,使用*_隔开要修改字体的文字即可,显示斜体使用*文字*_文字_(一个*_),粗体使用**文字**或者__文字__(两个*_),粗体倾斜使用***文字***___文字___(三个*_),删除字体使用~~文字~~,下划线则要使用HTML中的<u>标签,脚注使用[^标注文字]来添加比如:

这是一段文字,*这是斜体*,而**这是粗体**,***斜体加粗***,~~删除我吧~~。
这是一段脚注[^脚注]
[^脚注]:  这是一段脚注

显示为:
这是一段文字,这是斜体,而这是粗体斜体加粗删除我吧
这是一段脚注[1]

插入代码块

需要插入代码块进行引用时,可以使用`扩起单行,使用```扩起多行(```放于首行和尾行),并且可以指定使用的语言(也可以不指定),也可以在每行代码之前加四个空格或一个tab键(简书好像不行,可能需要设置tab键等于四个空格)。当代码块内需要加入反引号时,只需最外层的单引号比内层的多就可以了。比如:
`单行引用`显示为这是单行引用

``` python(指定语言)
print("hello world!")
print("你好,世界!")
```
  print("hello world!")

显示为:

print("hello world!")
print("你好,世界!")
print("hello world!")

在反引号内插入反引号(嵌套)

````
`print("hello world!")`

```
print("hello world!")
print("你好,世界!")
```
````

显示为:

`print("hello world!")`
```
print("hello world!")
print("你好,世界!")
```

分割线

三个及以上的-或*或_即可形成分割线,比如:

---
----
***
___

显示为:





插入表格

使用|分割不同的列,使用---:|:----:|:---进行分隔表头和内容,其中冒号在左边表示左对齐,冒号在两边表示居中对齐,冒号在右边表示右对齐,默认没有冒号的时候是左对齐,而短横线-的数量(至少一个)并不影响分隔效果,比如:

姓名 | 性别 | 年龄
-:|:----:|:---
小明 | 男  | 10
小丽 | 女  | 12

显示为:

姓名 性别 年龄
小明 10
小丽 12

转义

Markdown中使用了很多符号,要想在文本中使用字符本身,则可以在字符前面加上反斜杠\作为转义符。比如:

**粗体**
\*\*普通字体\*\*

显示为:
粗体
**普通字体**
支持转义的字符有:\ 反斜线

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

结语

个人学习笔记,仅供参考。
详细的教程可以参考菜鸟教程


  1. 这是一段脚注

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

推荐阅读更多精彩内容