Markdown语法的基本使用

简书的Markdown语法用着很舒服,总结一下Markdown语法吧。

为什么要学习Markdown语法?

Markdown 无处不在。StackOverflow、CSDN、掘金、简书、GitBook、有道云笔记、V2EX、光谷社区等。主流的代码托管平台,如 GitHub、GitLab、BitBucket、Coding、Gitee 等等,都支持 Markdown 语法,很多开源项目的 README、开发文档、帮助文档、Wiki 等都用 Markdown 写作。

Markdown 标题语法

语法描述:“#” + 标题文字

# 标题文字                           // 一级标题
## 标题文字                          // 二级标题
### 标题文字                         // 三级标题
#### 标题文字                        // 四级标题
##### 标题文字                       // 五级标题
###### 标题文字                      // 六级标题

效果:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

注:不同的Markdown应用程序处理 # 和标题文字之间的空格方式不一致。为了兼容考虑,建议使用一个空格在# 和标题之间

Markdown 段落语法

语法描述:使用空白行将一行或者多行文本进行分隔。

注:不要使用空格(spaces)或者制表符(tabs)缩进段落。

Markdown 换行语法

语法描述:在一行的末尾添加一个或者多个空格,然后按下回车键,即可创建一个换行。

注:几乎每个 Markdown 应用程序都支持两个或多个空格进行换行,称为 结尾空格(trailing whitespace) 的方式,但这是有争议的,因为很难在编辑器中直接看到空格,并且很多人在每个句子后面都会有意或无意地添加两个空格。由于这个原因,你可能要使用除结尾空格以外的其它方式来换行。幸运的是,几乎每个 Markdown 应用程序都支持另一种换行方式:HTML 的<br/> 标签。

为了兼容性,请在行尾添加“结尾空格”或 HTML 的 <br> 标签来实现换行。

还有两种其他方式我并不推荐使用。CommonMark 和其它几种轻量级标记语言支持在行尾添加反斜杠 () 的方式实现换行,但是并非所有 Markdown 应用程序都支持此种方式,因此从兼容性的角度来看,不推荐使用。并且至少有两种轻量级标记语言支持无须在行尾添加任何内容,只须键入回车键(return)即可实现换行。

Markdown 强调语法(粗体和斜体)

粗体 语法描述:要加粗文本,请在单词或短语的前后各添加两个星号(asterisks)或下划线(underscores)。如需加粗一个单词或短语的中间部分用以表示强调的话,请在要加粗部分的两侧各添加两个星号(asterisks)。

斜体 语法描述:要用斜体显示文本,请在单词或短语前后添加一个星号(asterisk)或下划线(underscore)。要斜体突出单词的中间部分,请在字母前后各添加一个星号,中间不要带空格。

**粗体**  __粗体__
*斜体*  _斜体_

效果:
粗体 粗体
斜体 斜体

注:Markdown 应用程序在处理单词或短语中间添加的下划线上并不一致。为了实现兼容性,请使用星号将单词或短语的中间部分加粗并以斜体显示,以示重要。

Markdown 引用语法

语法描述:要创建块引用,请在段落前添加一个 > 符号。

> 引用文字

效果:

引用文字

多段落的块引用

// 方法一:中间用空段落,使段落解析连续
> 吧啦吧啦吧啦
>
> 吧啦吧啦吧啦
// 方法二:使用换行符,不换段落
> 吧啦吧啦吧啦
<br/>吧啦吧啦吧啦

效果(方法一):

吧啦吧啦吧啦

吧啦吧啦吧啦

嵌套块引用

语法描述:块引用可以嵌套。在要嵌套的段落前添加一个 >> 符号。

> 吧啦吧啦吧啦.
>> 吧啦吧啦吧啦.

效果:

吧啦吧啦吧啦.

吧啦吧啦吧啦.

Markdown 列表语法

有序列表 语法描述:要创建有序列表,请在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列,但是列表应当以数字 1 起始。

无序列表 语法描述:要创建无序列表,请在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+) 。缩进一个或多个列表项可创建嵌套列表。

有序列表:

1. First item
2. Second item
3. Third item

嵌套
1. First item
2. Second item
3. Third item
    1. First item
    2. Second item
4. Fourth item

效果:

  1. First item
  2. Second item
  3. Third item

嵌套:

  1. First item
  2. Second item
  3. Third item
    1. First item
    2. Second item
  4. Fourth item
    无序列表
- First item
- Second item
- Third item

* First item
* Second item
* Third item

+ First item
+ Second item
+ Third item

- First item
- Second item
- Third item
    - Indented item
    - Indented item
- Fourth item

效果:

  • First item
  • Second item
  • Third item
  • First item
  • Second item
  • Third item
  • First item
  • Second item
  • Third item
  • First item
  • Second item
  • Third item
    • Indented item
    • Indented item
  • Fourth item

Markdown 代码块语法

语法描述:要将单词或短语表示为代码,请将其包裹在反引号 (```code block``` ) 中。

```code block```

效果:

{
  "name": "Eric",
  "age": "25"
}

指定代码的语言:在第一个 (```) 后面添加语言名称,并换行。

```javascript
javascript code block
```

效果:

function(arg1, arg2, ...arg3){
  console.log(arg1);
  console.log(arg2);
  console.log(arg3);
}
  • 问题来了:如果在代码块中使用 ```,如上面的示例
    用四个反引号(`)嵌入三个(`)


    image.png

Markdown 连接语法:

语法描述:[标题](链接地址)
效果:
必应搜索

Markdown 图面语法:

语法描述:![图片描述](图片链接地址)

除了这些这些常用的以外,还有 表格、使用 Emoji 表情、任务列表等,自行百度

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

推荐阅读更多精彩内容

  • 规则 本文档包含所有规则的描述,它们要检查的内容以及违反规则的文档示例和示例的更正版本。标题为击中 已弃用,但仍提...
    爱学习的小白F1阅读 5,501评论 0 0
  • Markdown For Typora 【抄自原网站】 概述 Markdown 由 Daring Fireball...
    大漠白杨JS阅读 751评论 0 1
  • 综述 Markdown 是Daring Fireball 发明的,这是官方的指导手册连接。然而,其语法根据不同的编...
    RenS_阅读 64,255评论 11 36
  • Markdown语法笔记 1.标题 一级标题 # 一级标题 二级标题 ## 二级标题 三级标题 ### 三级标题 ...
    zpeople阅读 550评论 1 0
  • 出发点 我是一个比较懒的人,平时看书看了也就是看了,并没有把自己看书的心得体会做一个总结并记录下来,然而岁月就像一...
    小云柳阅读 9,060评论 0 10