MarkDown语法简要汇总笔记

标题

  1. setext形式即用底线形式:最高级标题(=),二级标题(-)任何数量的‘=’和‘-’效果一样。

这是一级标题 ========
展示方式:
这是一级标题
=======

  1. atx形式:在行首插入1~6个'#',分别对应1~6级标题(行尾的‘#’与效果无关)。

# 这是一级标题 #
展示方式:

这是一级标题

区块引言

  1. 在MD文件中建立一个区块引言,看起来像是强迫断行,然后在每行最前面加‘>’,并且可循环套用。:

> 区块引言文本1
> > 子区块引言文本2
展示方式:

区块引言文本1

子区块引言文本2

  1. 区块引言也允许在整个段落的第一行最前面加上‘>’:

> 这是个段落 段落中的详细文本。 blablabla。
展示方式:

这是个段落
段落中的详细文本。
blablabla。

  1. 区块引言中亦可使用其它MD语法,包括标题、清单、程式等:

> ## 二级标题
>
> 1. 有序列表1.
> 2. 有序列表2
>
> 代码实例:
>
> return shell_exec("echo $input | $markdown_script");
** 展示方式: **

二级标题

  1. 有序列表1.
  2. 有序列表2

代码实例:

return shell_exec("echo $input | $markdown_script");

清单

_ MD支持有序列表无序列表。_

  1. 无序列表使用*+-作为清单标记。(混用亦可)

* red
+ Green
- blue
** 展示方式: **

  • red
  • Green
  • blue
  1. 有序列表使用数字接着一个英文句点

1. Bird
2. McHale
3. Parish
** 展示方式: **

  1. Bird
  2. McHale
  3. Parish

可以让MD文件的清单数字和输出的结果一致,也可不一致,即随意输入数字;

建议从1.开始,因为MD未来可能会有序列表的start属性。

  1. 关于清单列表的缩排:
  • 清单标记通常放在最左边,其实亦可缩排,最多3个空白,但标记后面一定要接着至少一个空白tab
  • 清單項目可以包含多個段落,每個項目下的段落都必須縮排4個空白或是一個tab
  • _在行首出现不预知的数字-句点-空白情况,可以在句点前加反斜杠\\避免。 _

* 这是第一行文本。
(加3个空白或者tab)这是第二行文本。
** 展示方式 **

  • 这是第一行文本。
    这是第二行文本。
  1. 清单内引用区块引言,则>需要缩进:

* 在清单中内置区块引用:
(空白或tab) > 需要缩排
** 展示方式: **

  • 在清单中内置区块引用:

    > 需要缩排

  1. 如果要放程式区块的话,该区块引言就要缩排2次,即8个空白2个tab:

* 列表中放入代码:
(2个tab或8个空白缩进)代码在这里
** 展示方式: **

  • 列表中放入代码:
    NSLog(@"hello world");

代码区块

  1. 代码或者标识语言原始码写作通常已经有排版好的区块。故我们并不希望它以一般段落文本的方式去排版,而是原样输出即可。
  2. MD自动会用<pre><code>标识来将代码块包起来。
  3. _在程式碼區塊裡面,&、<和>會自動轉成HTML實體,這樣的方式讓你非常容易使用Markdown插入範例用的HTML原始碼,只需要複製貼上,再加上縮排就可以了,剩下的Markdown都會幫你處理,
  4. 在MD中建立代码区块,只要简单的** 缩排4个空白1个tab即可。 **_ (一个代码块会一直持续到没有缩排的那一行) _ :

下面是个代码区块展示:
(4个空白或1个tab)NSLog(@"hello world") ;
**展示方式: **
下面是个代码区块展示:
NSLog(@"hello world") ;
NSLog(@"hello china") ;

    _ 附录:程式碼區塊中,一般的Markdown語法不會被轉換,像是星號便只是星號,這表示你可以很容易地以Markdown語法撰寫Markdown語法相關的文件。_

分割线

  1. 可在一行中用3个或者以上的*-_来建立一个分割线,但行内不能有其它元素。
    _亦可在*中间插入空白,均可建立分割线。
  2. 本示例以及下文中的MD原始语法,均以代码块的形式展示
 * *   *
 ***
 ***********
 --      --
 -*_
 ____

**展示方式: **





-*_


区段元素

  1. MD支持2种形式的链接语法:行内链接参考链接
  2. 链接的文字均是用[链接文字]来标识。
  行内链接
  这是 [示例1](http://www.baidu.com/ "title") inline link.
 [示例2](http://www.baidu.com/)没有title属性。

 连接同主机的资源,可以使用相对路径:
 点击关于 [About](/about) 查看详情。

 参考形式的链接:
 1. 使用另外一个[]接在链接文字的方括号后面,而在第二个[]里面要填入用以链接的标签。
 2. 然后在文件的其它任意处,把[id]标签链接内容定义出来。

 这是个 [参考链接][1] 的链接。
 定义[id]
 [a]:  http://www.baidu.com  "title"

** 展示方式: **
这是 示例1 inline link.
示例2 无title属性。

点击关于 About 查看详情。

这是个 [参考链接] [a] 的链接。
[a]: http://www.baidu.com "title"

强调

  1. MD使用*_作为标记强调字词的符号。符号和文本之间不留空白
 **`\*\*` 号展示着重文本形式**
 _ `_`号展示斜体文本形式 _

 **`\*\*` 号展示着重文本形式**
 __`\_\_`号展示着重文本形式__

** 展示方式: **

\*号展示斜体文本形式

\_号展示斜体文本形式

\*\* 号展示着重文本形式

\_\_号展示着重文本形式

代码

  1. 若要标记一小段行内代码,可以用\`号将其包起来:
 文本中间有代码:`NSLog(@"hello world");` 的MD标识方式。

** 展示方式: **

文本中间有代码:NSLog(@"hello world"); 的MD标识方式。

图片

  1. MD使用一种和链接很相似的语法来标记图片。同样也允许有2种样式:行内参考
  • (** 目前为止,无法指定图谱安的宽高,如需要,则使用普通的 <img>标签 **)

行内:
![alet 文本] (/path/to/img.jpg)
![alet 文本] (/path/to/img.jpg "title")
** 展示如下:
! [alet] (/path/to/img.jpg)
! [alet 文本] (/path/to/img.jpg "title")

参考:
! [alert text] [id]
[id]: url/to/image "title"
** 展示 **
! [alert text] [a]
[a]: url/to/image "title"

其他

  1. 自动链接(MD支持简短的自动链接,以处理网址和email地址)
 <http://www.baidu.com>

**展示: **
http://www.baidu.com

邮箱:
<address@e_mail.com>
** 展示: **
<address@e_mail.com>

跳脱字元

  1. MD可以利用 \来插入一些在语法中有其它意义的符号。如将*号置于文字旁边显示强调效果:
 \*  这是个显示强调效果的文本。 \* (此处无效果,待查)

** 展示 **
*这是个显示强调效果的文本。*

Markdown支援在下面這些符號前面加上反斜線來幫助插入普通的符號:

 \   反斜線
 `   反引號
 *   星號
 _   底線
 {}  大括號
 []  方括號
 ()  括號
 #   井字號
 +   加號
 -   減號
 .   英文句點
 !   驚嘆號

附:

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

推荐阅读更多精彩内容