【转】简书Markdown使用方法

原链接指路
补充

基本语法

标题

Markdown 支持两种标题的语法,类 Setext 和类 atx 形式。这里指介绍类atx形式:

#这是h1
##这是h2
###这是h3
####这是h4
#####这是h5
######这是h6

效果如下:

这是h1

这是h2

这是h3

这是h4

这是h5
这是h6

段落和换行

段落:一个或多个连续的文本行,段落内会强迫换行(插入换行符)
空行:这一行包括一个以上的空行(空行定义:看起来是空的,比如,某一行包括一个空格和一个制表符,也是一个空行)

代码区块

在每行加上4个空格或者一个制表符(如同写代码一样)

function a(){
}

注意:需要和普通段落之间存在空行!

区块引用

Markdown 标记区块引用是使用类似 email 中用 (>) 的引用方式。
段落引用:

>这是个段落引用
>
>这是个段落引用

效果如下:

这是个段落引用

这是个段落引用

段落引用也可以只写一个>

>This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

嵌套引用:

 This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.

效果如下:

This is nested blockquote.

Back to the first level.

嵌套引用中可以使用其他的语法:

> ## 这是一个标题。
> 
> 1\.   这是第一行列表项。
> 2\.   这是第二行列表项。
> 
> 给出一些例子代码:
> 
>     return shell_exec("echo $input | $markdown_script");

效果如下:

这是一个标题。

  1. 这是第一行列表项。
  2. 这是第二行列表项。

给出一些例子代码:

return shell_exec("echo $input | $markdown_script");

列表

Markdown 支持有序列表和无序列表。
无序列表使用星号、加号或是减号作为列表标记:

*   Red
*   Green
*   Blue

  • Red
  • Green
  • Blue
+   Red
+   Green
+   Blue

  • Red
  • Green
  • Blue
-   Red
-   Green
-   Blue

  • Red
  • Green
  • Blue
    有序列表则使用数字接着一个英文句点:
1\.  Bird
2\.  McHale
3\.  Parish

  1. Bird
  2. McHale
  3. Parish

在列表第二个标记之后使用的数字并不会影响输出的 HTML 结果,即你的数字可以不按顺序,但是编辑器会自动根据第一个输出:

3\.  Bird
1\.  McHale
3\.  Parish

  1. Bird
  2. McHale
  3. Parish

列表项目标记通常是放在最左边,缩进最多 3 个空格,项目标记后面则一定要接着至少一个空格或制表符。
列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符:

1.  This is a list item with two paragraphs. Lorem ipsum dolor
    sit amet, consectetuer adipiscing elit. Aliquam hendrerit
    mi posuere lectus.

    Vestibulum enim wisi, viverra nec, fringilla in, laoreet
    vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
    sit amet velit.

2.  Suspendisse id sem consectetuer libero luctus adipiscing.

  1. This is a list item with two paragraphs. Lorem ipsum dolor
    sit amet, consectetuer adipiscing elit. Aliquam hendrerit
    mi posuere lectus.

    Vestibulum enim wisi, viverra nec, fringilla in, laoreet
    vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
    sit amet velit.

  2. Suspendisse id sem consectetuer libero luctus adipiscing.

嵌套列表:在下一级输入一定空格即可。

*   Red 
     *   Red
     *   Green
     *   Blue     
*   Green
*   Blue

  • Red

    • Red
    • Green
    • Blue
  • Green

  • Blue

分割线

在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格

* * *

***

*****

- - -

---------------------------------------






表格

语法:

表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容

表头 表头 表头
内容 内容 内容
内容 内容 内容

第二行分割表头和内容。

  • 有一个就行,为了对齐,多加了几个
    文字默认居左
  • 两边加:表示文字居中
  • 右边加:表示文字居右
    注:原生的语法两边都要用 | 包起来。此处省略

字体

**这是加粗的文字**
*这是倾斜的文字*`
***这是斜体加粗的文字***
~~这是加删除线的文字~~

这是加粗的文字
这是倾斜的文字`
这是斜体加粗的文字
这是加删除线的文字

链接

Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。

This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

This is an example inline link.

This link has no title attribute.

链接到主机:

See my [About](/about/) page for details.

See my About page for details.
参考式的链接是在链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以辨识链接的标记:

This is [an example][id] reference-style link.

This is an example reference-style link.
接着,在文件的任意处,你可以把这个标记的链接内容定义出来:

[id]: http://example.com/  "Optional Title Here"

链接辨别标签可以有字母、数字、空白和标点符号,但是并不区分大小写。
链接语法可以帮助我们实现在MarkDown文档中写目录树,MarkDown会自动给每一个h1~h6标题生成一个锚,其id就是标题内容,目录树中的每一项都是一个跳转链接,点击后就会跳转到其对应的锚点(即标题所在位置)。可以有两种写法:

  1. 使用Markdown的语法来增加跳转链接:“名称”。
  2. 使用HTML语法来增加跳转链接:“<a href=”#id”>名称
[使用Markdown语法增加的跳转到“目录”的链接](#目录) 

效果:
使用Markdown语法增加的跳转到“目录”的链接

或者这么写:

<a href="#目录">使用HTML语法增加的跳转到“目录”的链接 

效果:
<a href="#目录">使用HTML语法增加的跳转到“目录”的链接

代码块

单行代码:

`
单行代码
`

单行代码

代码块:点由一个变成三个“```”

代码块

图片

语法

[图片上传失败...(image-651641-1550589378470)]

图片alt就是显示在图片下面的文字,相当于对图片内容的解释。
图片title是图片的标题,当鼠标移到图片上时显示的内容。title可加可不加
示例:

![程序猫](https://upload-images.jianshu.io/upload_images/15009210-
ca27889e0252066a.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

image

强调

Markdown 使用星号(*)和底线(_)作为标记强调字词的符号,被 * 或 _ 包围的字词会被转成用 <em> 标签包围,用两个 * 或 _ 包起来的话,则会被转成 <strong>

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

single asterisks

single underscores

double asterisks

double underscores
如果要在文字前后直接插入普通的星号或底线,你可以用反斜线:

\*this text is surrounded by literal asterisks\*

this text is surrounded by literal asterisks

公式

$$ x \href{why-equal.html}{=} y^2 + 1 $$
$ x = {-b \pm \sqrt{b^2-4ac} \over 2a}. $

[图片上传失败...(image-87dbd-1555328693162)]

[图片上传失败...(image-a993fe-1555328693162)]

脚注

Markdown[^1]
[^1]: Markdown是一种纯文本标记语言        // 在文章最后面显示脚注

Markdown[1]

自动邮箱链接

<xxx@outlook.com>

xxx@outlook.com


  1. Markdown是一种纯文本标记语言 // 在文章最后面显示脚注

作者:偶余杭
链接:https://www.jianshu.com/p/f3c14297f6da
来源:简书
简书著作权归作者所有,任何形式的转载都请联系作者获得授权并注明出处。

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