MarkDown标记语言语法

PS(2016.04): 三年前最开始学习 markdown 的时候记录的笔记,最近在重新整理之前的笔记,再次翻起与 markdown 相关的一系列笔记,这里重新整理一下。

基础语法规则

行内文字格式化

  1. 加粗:用两个 * 包裹文字即可,粗体
  2. 斜体:用一个 * 包裹文字即可,斜体
  3. 粗斜体:用三个 * 包裹文字即可,粗斜体

角注

角注使用[^1]这种方式添加[1]。具体使用方式如下:

引用角注[^1]

[^1]: 角注内容

图片和链接

  • 自动链接:<http://example.com/> 得到的是 http://example.com/
  • 带文字链接:[蘑菇街](http://www.mogujie.com) 得到的就是 蘑菇街

向页面中插入图片的方式与带文字链接类似,只不过前面多了个感叹号:

![当图片出不来显示的文字](http://upload-images.jianshu.io/upload_images/2283-476c245df0fe29fa.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
当图片出不来显示的文字

图片上带链接?只要图片整体当文字然后用文字链接的方式就可以了。

段落与换行

在 HTML 页面中,段落使用 <p></p> 标签包裹,而换行则使用 <br />。在 Markdown 的语法中,段落直接使用空行隔开即可,而段内换行则是行最后跟两个空格,再换到下一行继续书写。示例如下:

我是一段文字

我是一段文字,但我下面还有段内换行文字  
哈哈,我是段内换行的文字,你会发现上一行最后还有两个空格哦!

我是一段文字

我是一段文字,但我下面还有段内换行文字
哈哈,我是段内换行的文字,你会发现上一行最后还有两个空格哦!

标题

标题是每篇文章都需要也是最常用的格式,在 Markdown 中,如果一段文字被定义为标题,只要在这段文字前加 # 号即可。几级标题加几个 # 号。示例如下:

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

注:不推荐无节制地加标题,每个项目最好提前约定好标题级数的使用规范。

引用区块

在 HTML 页面中,引用区块使用的是 blockquote 标签,Markdown 语法提供了一种更方便的方式,效果其实前面的中已经展现了,在要引用的段文字最前加 >即可。(如果有多段,则每一段最前都要加)

> 我是引用内容
>
> 我也是引用内容

我是引用内容

我也是引用内容

列表

列表包括有序列表和无序列表,有序列表用数字开头,而无序列表使用 *-+ 开头,之后跟一个空格再添加内容,子列表需要相对父列表向右多两个空格且不能加空行。示例如下:

无序列表:

 - 无序列表1
   + 无序子列表
 - 无序列表2
  • 无序列表1
    • 无序子列表
  • 无序列表2

有序列表:(事实上,只要是数字就行,无需关注顺序,即便先写 2 再写 1 最终得到的也是按顺序排列的列表)

2. 有序列表1
  a. 有序子列表
1. 有序列表2
  1. 无序列表1
  • 无序
  1. 无序列表2

如果列表之间加了空行,就会被解释成两段内容,也许得到的就并不是你想要的了。

代码块

代码块分两种,内联代码及块代码,对应于 HTML 中的 codepre 标签。内联代码很简单,用 ` 号(键盘上数字 1 左边那个键)包裹起来即可。而块代码则有两种方式:

  1. 使用三个 ` 来包裹代码块,这种方式可以自定义语法高亮

  2. 将代码块向右缩进四个空格,这种方式不会带任何语法高亮

     ```javascript
     console.log('hello world');
     ```    
    

这时,你看到的效果会是:

console.log('hello world');

分隔线

当一行元素为 * * * 的时候,就是下面这种效果的分隔线了:



  1. 角注

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

推荐阅读更多精彩内容