你可能不知道的 Markdown 骚操作

前言

Markdown 是我们广大程序员最熟悉的一门语言之一,因为它易读,语义化等特点,被我们广泛用于文档编写中,可以说是和 JSON 相提并论的一种通用语法。

可你是否知道,Markdown 其实玩出很多骚操作呢?今天,我们用基于 CommonMark 的 GFM 规范为例,给大家总结了以下的骚操作。

正文

操作一:Tab 不等效空格的情况

图片中的 -> 即代表 tab 键

在 Markdown 中,一个 Tab 和四个空格通常是等效的。

image

示例代码

  - foo

    bar

但如果 tab 作为文字内部的字符传递,就不会等效为四个空格。

image

示例代码

    foo    baz        bim

操作二:在围栏代码块里显示三个 `

我们有的时候需要在 Markdown 中编写一个 Markdown 的代码块,就像这样:

```js
const a = 2;
```

这时候围栏如果还是用三个 ` 的话,会解析失败。其实我们还可以用 ~ 来做代码块的围栏。

image

示例代码

~~~
aaa
```
~~~

当然,还有你要坚持用 `,也可以,只要让外层的围栏长度更长一些即可:

示例代码

````
aaa
```
``````

操作三:围栏可以缩进

如果起始围栏是缩进的,则内容行将删除等效的起始缩进(如果存在的话):

示例代码

 ```
 aaa
aaa
```
  ```
aaa
  aaa
aaa
  ```
   ```
   aaa
    aaa
  aaa
   ```

操作四:在 Markdown 中写注释

你以为 Markdown 写出来的东西都是明文吗?其实并不然,因为兼容 HTML 的原因,所以 HTML 格式的注释也是支持的:

示例代码

foo <!-- this is a
comment - with hyphen -->

操作五:可以在 HTML 中包含 Markdown 内容

只需使用空行将 Markdown 与 HTML 分开:

示例代码

<div>

*Emphasized* text.

</div>

操作六:使用链接引用定义避免重复写链接地址

有时候,我们一篇文章会出现很多个重复链接,这时候,我们可以使用链接引用定义来避免重复写链接地址:

示例代码

[foo]: /url "title"

[foo]

操作七:表格行的单元格数量上可以有所不同

表格不同行的部分可以在单元格数量上有所不同。如果有多个单元格小于标题行中的单元格数,则插入空单元格。如果有多的,则忽略多余的:


示例代码

| abc | def |
| --- | --- |
| bar |
| bar | baz | boo |

操作八:块引用的延迟原则

块引用的延迟原则可以使我们省略段落延续文本前面的 >:

示例代码

> # Foo
> bar
baz

操作九:多个块引用放到一起,会得到一个大的块引用

这称为块引用的持续性。

示例代码

> foo
> bar

操作十:起始序号可以用 0 开头:

示例代码

0. ok

操作十一:改变无序或者有序列表的分隔符会另起新列表

示例代码

- foo
- bar
+ baz

操作十二:强制换行

方法一:在行末加上反斜杠会被认为是强制换行

示例代码

foo\
baz

但在段落或其他块元素的末尾,这种方法不起作用:

方法二:可以在行尾使用两个或多个空格

示例代码

foo  
baz

操作十三:小心使用强调分隔符和标点符号一起的情况

左侧分隔符后面出现标点符号,前面出现字母或数字。或者右侧分隔符前面出现标点符号,后面出现字母或数字不算强调:

示例代码

a*"foo"*

操作十四:强调可以嵌套

示例代码

_foo __bar__ baz_

操作十五:链接标签不区分大小写

示例代码

[Foo]

[foo]: /url "title"

结语

Markdown 是一门方便的编写结构化文档的语言。在熟悉了基本语法后再抽空去了解一下规范,可以使我们在日常的文档编写中效率更高。

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

推荐阅读更多精彩内容