Markdown基本语法总结

Markdown最大的特点是易读易写,其目标是成为一种容易书写的网络语言。

Markdown 有如下显著优点:

  • 纯文本,兼容性极强,可以用所有文本编辑器打开。
  • 格式转换方便,Markdown 的文本你可以轻松转换为 html、电子书等。
  • Markdown 的标记语法有极好的可读性。

由于受多种text-to-HTML语言的影响,Markdown的基本语法中有一些输出效果相同的输入方法。在下面的基本语法总结中我们着重来讨论这一内容。

标题

Markdown 支持两种标题的语法,Setext和atx形式。Atx 形式在行首插入 1 到 6 个#,对应到标题 1 到 6 阶;Setext 形式是用底线的形式,利用=(最高阶标题)和-(第二阶标题)。例如:


#、=和-与标题的阶.png

两种方法的HTML语言输出是一致的。


标题-HTML输出.png

输出的标题自然也是等效的:
#与标题的阶.png

=、-与标题的阶.png

修辞和强调

Markdown 使用星号和底线来标记需要强调的区段。两个“”包含一段文本就是粗体的语法,一个“”包含一段文本就是斜体的语法。例如:

字体强调.png

两种字体强调方法的输出效果是一样的。


两种字体强调方法的输出效果.png

分隔符

分隔符通常用三个以上的“-”或“*”表示,如图:


分隔符.png

输入短横线显示的分隔符通常是不显示的,输入星号显示的分隔符呈现短线分割的样式。


两种分隔符的效果.png

列表

无序列表

无序列表使用星号、加号和减号来做为列表的项目标记,三者的效果是一样的。


无序列表表达1.png
无序列表表达2.png
无序列表表达3.png

三者输出等效:


无序列表输出.png
有序列表

在有序表中,只能使用使用数字序号加一个英文句点来标识项目,在按递增顺序输入数字序号时,输入与输出效果大致相同:


有序列表的输入与输出.png

在列表标记上使用的数字并不会影响输出的 HTML 结果,上面的列表所产生的 HTML 标记为:


有序列表的HTML输出.png

因此,无论输入的数字序号是多少,都不会影响输出。

图片与文字链接

Markdown 内插入链接有两种方法:替代文字和<链接地址>。有替代文字的则以替代文字的形式呈现超链接,没有则以网址的形式呈现。

两种插入链接的方法.png

链接的输出.png

引用

通常,用“>”号插入引用。


引用.png

引用的输出.png

如上图所示,插入的“<>”的个数不影响引用效果。
在引用中插入标题和代码:


在引用中插入标题和代码.png
在引用中插入标题和代码的输出.png

行内代码

如果要标记一小段行内代码,可以在代码前tab空格,也可以用反引号把它包起来(`),例如:


行内代码的输入.png

行内代码的输出.png

如果要插入规模较大的代码块,也一样可以在代码前面tab空格或者在代码的开始和末尾插入反引号,不同的是需要用多个反引号来开启和结束代码区段。代码区段的起始和结束端都可以放入一个空白,起始端后面一个,结束端前面一个,这样你就可以在区段的一开始就插入反引号。


图片.png

表格

在Markdown 中创建表格,有简单方式和原生方式。

原生方式.png

简单方式.png
表格输出.png

不管是哪种方式,基本语法都大致相同:

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

推荐阅读更多精彩内容

  • Markdown 是一种轻量级标记语言,能将文本换成有效的XHTML(或者HTML)文档,它的目标是实现易读易写,...
    萌萌的wo阅读 350评论 0 0
  • Markdown是一种轻量级的标记语言,但它并不复杂,算下来一共只有十多种,熟悉后写作效率能得到极大提升。 简单来...
    YKishere阅读 376评论 0 0
  • 目录 标题 列表 引用 表格 代码引用 粗体与斜体 图片与连接 1. 标题 在 Markdown 中,需要在文本前...
    YANGXIAOFEI阅读 1,832评论 0 0
  • 快捷键 加粗 Ctrl + B 斜体 Ctrl + I 引用 Ctrl + Q 插入链接 ...
    IAMGCL阅读 381评论 0 0
  • 标题 # 一级标题## 二级标题 Markdown可以使用#来标示标题。一个#后面跟的内容是一级标题,一般一级标题...
    咸鱼有梦想呀阅读 223评论 0 1