markdown语法

http://www.ituring.com.cn/article/504

常用语法
3.2.1 标题
语法标记:#
(#号+空格)作用域:行语法位置:前置(同行前置,写在目标文字开头)语法方向:后向好用等级:(5颗星)解说**:#
支持6个级别的标题,#
号的数量代表标题的级别。

图1-1. 6级标题

语法标记:=
、-
(等号、减号)作用域:行语法位置:后置(写在目标文字下方,类似给文字加底线)语法方向:前向(对前一行内容有效)好用等级:(2颗星)解说:=
、-
支持2个级别的标题,=
标记一级标题,-
标记二级标题。原则上符号数量不限,但各编辑器支持方式略有差异。后置语法在Markdown中并不常用,所以,这种标记方式了解即可。

图1-2. 2级标题

3.2.2 分割线
语法标记:***
、---
、___
(3个星号、减号、底线)作用域:行(空行)语法位置:前置(写在空行行首)语法方向:后向好用等级:(4颗星)解说:***
、---
或___
将一个空行标记为分割线,一般分割线前后也会各留一个空行。华丽的分割线是部分写手的钟爱,不用也无损大雅,各取所需吧。

图2. 两种分割线写法

3.2.3 列表
标记符号(有序列表):1.
(序号数字+点号+空格)标记符号(无序列表):*
、+
、-
(注意空格符号后面有空格)作用域:行语法位置:前置语法方向:后向好用等级:(5颗星)解说:列表有有序和无序之分。--有序列表,在逻辑顺序上具有先后关系。--无序列表,条目之间只做横向比较或罗列。另,结合Tab
缩进可实现列表的嵌套,比如在一个条目下还有3个子条目,则3个子条目仍然可以写成低一级别的列表。合理运用列表,文章逻辑条理更清晰,结构层次更分明。

图3. 两种列表形式

3.2.4 引用
标记符号:>
(大于号+空格)作用域:段语法位置:前置(添加在段首,第一行之前)语法方向:后向好用等级:(5颗星)解说:在需要引用的段落前加上">"和空格,如:> 光明源于黑暗,黑暗涌现光明
。引用也可以嵌套。另外,也有同学给标题添加引用标记,展现效果同样出色。

图4. 引用

3.2.5 链接
语法符号:
([ ]中放锚文本,()中放链接地址)如:简书
作用域:区间(锚文本)语法位置:端置语法方向:对向好用等级:(4颗星)解说:根据不同使用场景,文字链接有内联和引用两种方式。--内联方式,满足一般使用需求,直观方便,即用即写。--引用方式,适合添加多个网址的文章,可以避免在正文中出现大量网址,保持编辑可读性;也适合同一网址多处引用,当网址有改动或修改时,只需修改列表即可,无需逐个修改,类似宏定义。

[图片上传中。。。(6)]图5. 文字链接

3.2.6 图片
语法符号:


([ ]中放图片说明,()中放图片链接)如:
图6.图片

作用域:无(插入性语法,无作用域)语法位置:不限语法方向:无(插入性语法,无方向性)好用等级:(3颗星)解说:江湖传言“字不如表,表不如图”、“一图胜千文”、“无图无真相”云云,图片重要性不言自寓,然而缺少好的图床,完美的语法没有完美的解决方案,一样是没有什么卵用。当然,在简书上写作非常省心,图片处理就是直接拖进编辑区,这一点真的很贴心。与文字链相同,图片也有内联引用两种方式。

图6. 图片链接

3.2.7 强调
语法标记:* *
、_ _
(星号对或底线对)作用域:区间语法位置:端置语法方向:对向好用等级:(4颗星)解说:强调有3种形式,分别为:单星对* *
斜体强调、双星对** **
加粗强调、三星对*** ***
斜体加粗强调。

[图片上传中。。。(8)]图7. 强调

3.2.8 脚注
语法标记:[^1]
+[^1]:注释内容
([^1]
是角标,[^1]:注释内容
是对应的注释列表,必须一一对应)作用域:无(插入性语法,无作用域)语法位置:注释点(一般插入在需注释词汇的后面)语法方向:无(插入性语法,无方向性)好用等级:(4颗星)解说:写文章时,不可避免要用到读者陌生的词汇或典故,就地解释会把文风带偏,不作说明显然治学不严,脚注为此而生。

图8. 脚注

3.2.9 代码
语法标记:
(Tab
缩进或连续空格)、
号对,注:
号俗称“小句号”,和波浪号在同一按键上)作用域:行语法位置:空格或缩进为前置、号对为端置语法方向:空格或缩进为后向、
号对为对向好用等级:(3颗星)解说:对程序猿(媛)同学来说,要在文章中插入一段代码,怎么办?--代码行:单`
号对可以实现代码行效果;cout<<"hello world!"<<endl;
--代码区:Tab
缩进或连续空格,实现代码区块的效果(注意代码区要独立成段,且每行都要缩进)。

void main() { cout<<"hello world!"<<endl; }

图9. 代码

3.2.10 表格
语法标记:|
和-
和:
组合作用域:段、区间语法位置:组合型语法方向:组合型好用等级:(1颗星)解说:表格在Markdown语法中真是个鸡肋,如果非用不可倒也无妨。--|
和|
之间形成单元格。--第一行为表头,内容默认加粗居中。--第二行-
和:
组合,标记本列单元格对齐方式。无:
号,为默认左对齐;两端:
为居中;左、右其中一端:
向该侧对齐。--其余行为普通单元格。注意:(1)第二行不可省略,否则语法不完整;(2)表格必须为整段,中间不能有空行。

| 表头 | 表头 | 表头 | | ------- |:-------:| -----: || 11 |12 |13 || 21 |22 |23 || 31 |32 |33 || 41 |42 |43 |

图10.表格

文/Mr_Professor(简书作者)原文链接:http://www.jianshu.com/p/8c1d594afd85著作权归作者所有,转载请联系作者获得授权,并标注“简书作者”。

推荐阅读更多精彩内容

  • Markdown 语法 以下是 Markdown 的常用语法!在以后的笔记中将持续使用 Markdown 语法进行...
    WinSolstice阅读 528评论 0 1
  • 上课总结:从机器语言(010101010)->汇编语言(add 1,2)有意义的英文单词--->结构化->面向对象...
    在腊月天阅读 195评论 1 1
  • 声明: 这份文档派生(fork)于繁体中文版,在此基础上进行了繁体转简体工作,并进行了适当的润色。此文档用 Mar...
    Cellei阅读 3,857评论 0 22
  • 一人拾柴火不旺,众人拾柴火焰高。 一人难挑千斤担,众人能移万座山。 9月1号开学以来,...
    大海一滴水阅读 199评论 0 1
  • 写这个话题,其实思考了很久,很怕我没有勇气写下去,外公去世六年多了,但如今此刻提起这...
    芋圆西米丸子阅读 103评论 2 4