Markdown快速入门

引言

觉得自己有必要要学学Markdown了,但同时担心光看自己记不住,同时想作为工具书日后忘记用于回顾。
本文删去了Markdown语法说明中的一些如md与html之间的转义等繁琐说明,教之更为精简,更专注于Markdown本身语法。

区块元素

标题

在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶,例如:

# 这是 H1
## 这是 H2
### 这是 H3
#### 这是H4
#####这是H5
###### 这是 H6

实际效果如下:

这是 H1

这是 H2

这是 H3

这是H4

这是H5
这是 H6

区块引用

在最前面加上 > 即可

> 这是一个区块引用
只在第一行加 >

效果等同于:
> 这是一个区块引用
> 每行都加 >

> 这是一个区块引用
> > 嵌套使用>

> #### 在引用中使用标题。
> 
> 1.   在引用中使用列表项。

> 空四个格子或一个制表符引用代码:
> 
>     //test
>     public class Main{
>
>     }

实际效果:

这是一个区块引用

这是一个区块引用
每行都加 >

这是一个区块引用

嵌套使用>

在引用中使用标题。

  1. 在引用中使用列表项。

空四个格子或一个制表符引用代码:

//test
public class Main{

}

列表

无序列表使用星号、加号或减号标记(三者互相等同):

* unordered list 1
+ unordered list 2
- unordered list 3

在无需列表项内放入引用,需要缩进4格:
1.列表项
     > 引用内容

在无需列表项内放入代码块,需要空一行缩进8格:
1.列表项

         代码块

效果如下:

  • unordered list *
  • unordered list *
  • unordered list -
  • unordered list -
  • unordered list +
  • unordered list +
  • 无序列表项

    引用内容

  • 无序列表项

      代码块
    

有序列表使用数字接一个英文句号:

1. 表项1
2. 表项2
3. 表项3

效果如下:

  1. 表项1
  2. 表项2
  3. 表项3

(注意:有序列表不支持加入引用和代码块)

代码区块

在Markdown中建立代码区块,只需要空一行并缩进4个空格或一个制表符即可:

如下:
代码区块的前一行文字:
  
    (代码内容)

效果如下:

代码区块前一行文字:

(代码内容)

分割线

用三个以上的星号、减号、底线来建立分割线,行内不能有其他东西:

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

效果如下:





区段元素

链接

Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。

行内式链接语法

在方块括号(显示文本)后面紧接着圆括号并插入网址链接即可,如果你还想要加上链接的标题,只要在网址后面,用双引号把文字包起来即可,例如:

这是一个行内式[链接](http://example.com/ "标题") 。

这个行内式[链接](http://example.net/) 没有标题属性。

连接到[本地](/local/ "本地资源")资源。

效果如下:

这是一个行内式链接 .
这个行内式链接 没有标题属性.
连接到本地资源。

参考式链接语法

参考式的链接是在链接文字的括号后面再接上另一个方括号,第二个方括号里填入的是用以唯一标识链接的标记id,例如:

这是一个参考式[链接][link1]。
......

然后在这个markdown文件的任意处定义上面的标记:
    [link1]: http://example.com/ "参考式链接标题"
也可以写成这样:
    [link1]: <http://example.com/> "参考式链接标题"

标签可以由字母、数字、空白和标点符号组成,但是并不区分大小写,因此下面两个链接是一样的:
    [link text][a]
    [link text][A]

隐式链接标记,形如[link][],第二个方括号空着,可以省略指定链接ID,这种情形下,ID会视为等同于链接文字。

效果如下:

这是一个参考式链接
隐式link2(虽然直观上看不出来)。

强调

Markdown 使用星号(*)和底线(_)作为标记强调字词的符号。
被 * 或 _ 包围的字词会被转成斜体,用两个 * 或 _ 包起来的话,则会被转成粗体,例如:

*单星号强调(斜体)*

_单下划线强调(斜体)_

**双星号强调(粗体)**

__双下划线强调(粗体)__

***三符号强调(斜体+粗体)***

插在**文字**中间的强调

反斜杠来显示 \*号

效果如下:

单星号强调(斜体)
单下划线强调(斜体)
双星号强调(粗体)
双下划线强调(粗体)
三符号强调(斜体+粗体)
插在文字中间的强调
反斜杠来显示 *号

行内代码

标记一小段行内代码,用反引号将代码包起来,例如:

`code`写的非常的烂。

``用两个反引号来显示代码中的反引号(`)``

用两个\`\`来包围代码并空格分开来显示代码开头和结尾的反引号: `` `foo` ``

效果如下:

printp("是printf不是printp");这里写错了。
用两个反引号来显示代码中的反引号(`)
用两个``来包围代码并空格分开来显示代码开头和结尾的反引号: `foo`

图片

Markdown 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内式和参考式。
其实图片链接的语法类似,只是多了一个感叹号(!)而已,并没有看上去那么复杂。

行内式图片

行内式的图片语法是使用一个感叹号接一对方括号接一对圆括号,圆括号里面放入放上图片的网址,后面可以用引号包住选择性的标题文字,例如:

![](/path/to/img.jpg "可选标题")

效果如下:


网络图片
网络图片

参考式图片

参考式的图片语法是使用一个感叹号接一对方括号,再接上一对方括号,例如:

![可选文字][id]
......
同样的在md文件任意处定义id
[id]: url/to/image  "可选标题"

效果如下:

网络图片
网络图片

其他

自动链接

只要是用尖括号包起来, Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样,例如:

<http://example.com/>
<address@example.com>

效果如下:

http://example.com/
address@example.com

反斜杠

可以利用反斜杠来插入一些在语法中有其它意义的符号,例如:

\*
\-
\+

效果如下:

*
-
+

表格

123
345
见例:

//注意第二行的冒号(:)
//结合效果展示可以看出:
//默认不加冒号为文字靠左,两边都加冒号为文字居中,加在右边为文字靠右

|Attribute1|Attribute2|Attribute3|Attribute4|
|----------|:----------|--------:|:--------:|
|mem1|mem1|mem1|mem1|
|mem2|mem2|mem2|mem2|

效果如下:

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

推荐阅读更多精彩内容

  • Markdown 1. 兼容HTML Markdown语法的目标是:成为一种适用于网络的书写语言。Markdown...
    晴天sy阅读 227评论 0 0
  • 段落、标题、区块代码 一个段落是由一个以上的连接的行句组成,而一个以上的空行则会划分出不同的段落(空行的定义是显示...
    garyond阅读 194评论 0 2
  • 刚接触Markdown,总结一些常用语法,希望能帮助一些像我一样的初学者快速入门。 一、段落前面的空格 输入法切换...
    sunnygarden阅读 965评论 0 1
  • 一、概述 Markdown是一种轻量级的标记语言,与之对应的是重量级的HTML。 它通过少量简单的语法就可以轻易实...
    凛_冬_将_至阅读 1,681评论 0 1
  • 标题 标题(h1~h6)可使用相应个数的#来生成,如下面的代码将会生成h3:### this is a level...
    proud2008阅读 300评论 0 0