Markdown通用的常用语法说明

markdown-logo

前言

Markdown 是一种轻量级的 标记语言,语法简洁明了、学习容易,还具有其他很多优点,目前被越来越多的人用来写作使用。

Markdown具有一系列衍生版本,用于扩展Markdown的功能(如表格、脚注、内嵌HTML等等),这些功能原初的Markdown尚不具备,它们能让Markdown转换成更多的格式,例如LaTeX,Docbook。Markdown增强版中比较有名的有Markdown Extra、MultiMarkdown、 Maruku等。这些衍生版本要么基于工具,如Pandoc;要么基于网站,如GitHub和Wikipedia,在语法上基本兼容,但在一些语法和渲染效果上有改动。

由于一些扩展只在特定的环境中才能实现,所以这里介绍的是通用的常用语法说明。

语法

下面就是常用的Markdown语法内容,以标准Markdown语法为依据,可能这里有一些差异,请以语法为准。

标题

标题分为6级,对应HTML标签的h1~h6。#越多,字体越小。

# H1标题
## H2标题
### H3标题
#### H4标题
##### H5标题
###### H6标题

H1标题

H2标题

H3标题

H4标题

H5标题
H6标题

分隔符

分隔符就是一条横线。

---

文本样式

斜体

* 斜体文本 *
_ 斜体文本 _

斜体文本 斜体文本

粗体

加粗就是是文字为粗体显示,可以使用下面两中方式表示:

**粗体文本**
__粗体文本__

粗体文本

粗体文本

斜粗体

***斜粗体文本*** *__斜粗体文本__*
_**斜粗体文本**_ ___斜粗体文本___

斜粗体文本 斜粗体文本

斜粗体文本 斜粗体文本

删除线

文字有一条删除线的效果

~~ 删除效果 ~~

删除效果

高亮

文字用醒目的高亮显示

这是` 高亮文本 `效果。

这是高亮文本效果。

代码块

代码块就是将源码直接进行展示,可在开始的** ``` **后面加上代码语种名称。

`` `  javascript
var str = "hello world!";
alert(str);
`` `

为了显示,上面给出的```加了一个空格。

var str = "hello world!";
alert(str);

上面就是效果

图片

图片展示

方式1:
![文本内容](https://help.github.com/assets/images/site/favicon.ico "logo")
方式2:
![文本内容][img]
[img]:https://help.github.com/assets/images/site/favicon.ico "logo"

方式1:

文本内容
文本内容

方式2:
![文本内容][img]
[img]:https://help.github.com/assets/images/site/favicon.ico "logo"

<h6 id="url-more">说明:</h6>

URL后面的内容是鼠标hover提示文本,可以省略,省略时就没有鼠标hover提示文本效果。

推荐使用方式2,当一个链接在文中多次出现的时候,就会体现出其优点了。

另外,后面的提示文本除了使用 "提示文本" 外,还可以是 '提示文本'(提示文本)

[id]:URL "鼠标hover提示文本"
[id]:URL '鼠标hover提示文本'
[id]:URL (鼠标hover提示文本)

链接

链接根据链接目标可分为站内站外链接,按照类型可分为文本链接和图片链接。
综上所述,可分为以下三种:

文本链接

给文本信息添加超链接

1.<https://github.com/SeayXu>
2.[文本链接](https://github.com/SeayXu "SeayXu")
3.[文本链接][id]
[id]:https://github.com/SeayXu "SeayXu"

1.https://github.com/SeayXu
2.文本链接
3.[文本链接][id]
[id]:https://github.com/SeayXu "SeayXu"

链接URL相关说明和图片一样,请查看

特例:
当链接的文本内容和链接Id相同的时候,可以不用写链接后面的Id。

[SeayXu][]
[SeayXu]: https://github.com/SeayXu "Seay"

[SeayXu][]
[SeayXu]: https://github.com/SeayXu "Seay"

图片链接

给图片加上超链接

方式1:
[![Github](https://help.github.com/assets/images/site/favicon.ico "Seay")](https://github.com/SeayXu  "SeayXu")
方式2:
[![Github][img-url]][link-url]
[link-url]:https://github.com/SeayXu "SeayXu"
[img-url]:https://help.github.com/assets/images/site/favicon.ico "Seay"

方式1:


方式2:
![Github][github-img]

提示:由于各个Markdown解析不同,所以显示的提示文本有可能也不太一样。

锚点

锚点其实与文本链接和图片链接用法是一样的,只不过是在本页面内,需要稍微改动下。

设置锚点链接目标:

<h6 id="url-more">说明:</h6>

添加锚点:

[锚点](#url-more "anchor alt text")
[锚点][anchor]
[anchor]:#url-more "anchor alt text"

锚点
[锚点][anchor]
[anchor]:#url-more "anchor alt text"

说明:相对于文本链接和图片链接,主要是添加了锚点链接目标这一操作,使用语法跟文本链接和图片链接一样。

列表

列表分为有序和无序两种。

无序列表

无序列表有三种表示方法:*+-

下级在上级基础上前面多加两个空格,符号与内容直接有一个空格。

无序列表1:

* 一级条目1
* 一级条目2
  * 二级条目1
  * 二级条目2
    * 三级条目1
    * 三级条目2
    * 三级条目3
  * 二级条目3
* 一级条目3
  • 一级条目1
  • 一级条目2
    • 二级条目1
    • 二级条目2
      • 三级条目1
      • 三级条目2
      • 三级条目3
    • 二级条目3
  • 一级条目3

在这里只演示一种,另外两种就是把 * 分别换成 +-

有序列表

有序列表与无序列表类似,只不是是将前面的符号换成数字而已。

1. 一级条目1
2. 一级条目2
  1. 二级条目1
  * 二级条目2
    * 三级条目1
    + 三级条目2
    - 三级条目3
  - 二级条目3
2. 一级条目3
  1. 一级条目1
  2. 一级条目2
  3. 二级条目1
  • 二级条目2
    • 三级条目1
    • 三级条目2
    • 三级条目3
  • 二级条目3
  1. 一级条目3

说明:

  1. 有序列表有自动纠错功能,当序号输入错误时,会自动更正显示序号。
  2. 有序列表可结合无序列表,只在第一个条目输入序号后,同级条目会自动编号。

引用

引用内容可以嵌套引用和使用其他语法,在引用内容后面空一行就表示引用结束。

>这是一段包含**加粗**的 _斜体_ 和 _**斜粗体**_ 并带有`高亮`显示的一段文本来自[我的Github](https://github.com/SeayXu "SeayXu")。
我是图片:
![github logo][github-img]
[github-url]:https://github.com/SeayXu "SeayXu"

这是一段包含加粗斜体斜粗体 并带有高亮显示的一段文本来自我的Github
我是图片:

github logo
github logo

本文来自:markdown-general-common-syntax
本文就介绍到这里,如有不足之处,可随时与我联系。

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

推荐阅读更多精彩内容

  • 标题 标题分为6级,对应HTML标签的h1~h6。#越多,字体越小。#H1标题## H2标题### H3标题###...
    疯范儿阅读 403评论 0 0
  • Markdown是一种轻量级的[标记语言],它的优点很多,目前也被越来越多的写作爱好者,撰稿者广泛使用。看到这里请...
    李阿昀阅读 18,625评论 1 18
  • 1. 斜体和粗体 代码: 显示效果: 这是一段斜体 这是一段粗体 这是一段加粗斜体 这是一段删除线 2. 分级标题...
    泊牧阅读 2,250评论 0 2
  • 人生 总在经受岁月的磨折之后 方至懂得了珍惜身边的人 比你快乐 人生 总在经受风雨的洗礼 方至懂得你所希望的我 是...
    小草_d5ad阅读 455评论 21 50
  • 欣赏好的,但不指望未来都是好的。
    乞力马扎罗的咸鱼阅读 384评论 0 1