【转】简书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
来源:简书
简书著作权归作者所有,任何形式的转载都请联系作者获得授权并注明出处。

全部评论

相关推荐

点赞 评论 收藏
分享
点赞 收藏 评论
分享
牛客网
牛客企业服务