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. 可在第二行指定不同列单元格内容的对齐方式,默认为左对齐,在 “-” 右边加上 “:” 为右对齐,在 “-” 两侧同时加上 “:” 为居中对齐。
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

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