Markdown 7min快速入门

目录

• 概述
  • 宗旨
  • 兼容
  • 特殊字符自动换行
• 区块元素
  • 段落和换行
  • 标题
  • 区块引用
  • 列表
  • 代码区块
  • 分隔线
• 区段元素
  • 链接
  • 强调
  • 代码
  • 图片
• 其他
  • 表格
  • 删除线
  • 注脚
  • 锚点
  • 反斜杠
  • 自动链接

• 参考文献

  正文

  概述

  宗旨

  Markdown是一种以易于读写为目的的纯文本撰写格式。

  兼容HTML

  Markdown语法是一种实现了适用于网络的书写语言。

  特殊字符自动转换

  在HTML文件中，有两个字符需要特殊处理:<和&。如果要使用这两个字符的原型，就应当使用他们的实体形式:<和&

  区块元素

  段落和换行

  一个Markdown段落是由一个或者多个连续的文本行组成，它的前后要有一个以上的空行。普通段落不应该用空格或制表符来缩进。

如果的确需要依赖Markdown来插入<br/>标签的话，在插入处先键入两个以上空格然后回车。

标题

Markdown支持两种标题的语法，类Setext和类atx形式。

• 类Setext形式是用底线的方式，利用＝和-，例如:

这是H1标题
==========
这是H2标题
----------

这里是H1标题

## 这里是H2标题

• 类Atx形式则是在首行插入1到6个#，例如:

# 这里是H1
## 这里是H2

这里是H1标题

这里是H2标题

区块引用

Markdown中的区块引用即先断好行，然后在每一行或整段的第一行的最前面加上>。

> abcd
> 
> efgh
> 
> ljkm

abcd

efgh

ljkm

而引用的区块内也可以使用Markdown语法。

> # 这是一个标题
> 
> 1.
> 2.
> 
> 给出一些代码例子:
> 
> renturn shell_exec("echo $input|$markdown_script");

这是一个标题

给出一些代码例子:

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

列表

Markdown中支持有序列表和无序列表。

• 无序列表使用星号、加号或者是减号作为列表标记。

- 红
* 黄
+ 绿

• 红
• 黄
• 绿

• 有序列表采用数字加一个英文句号(与数字顺序无关)。

1. 红
3. 黄
2. 绿

1. 红
2. 黄
3. 绿

代码区块

代码需要按照原先的排版进行显实。在Markdown中显实代码区块只需要简单的缩进4个空格或是1个制表符即可。

这是一段普通段落
    
    这是一段代码区块

这是一段普通段落

这是一段代码区块

分割线

Markdown使用在一行中用三个以上的星号、减号、底线来建立分割线。

*****

-----

_____

---

---

---

区段元素

链接

Mrakdown支持两种形式的链接语法:行内式和参考式两种形式。而无论使用哪种形式，链接文字均是用[]来标记。

• 要建立一个行内式的链接，只用在方括号后的圆括号()内插入链接网址即可。如果还想为链接加上title文字，只用在网址后用双引号""把title文字包起来即可。

可以通过[百度](http://www.baidu.com/"百度一下")来查询

可以通过百度来查询

• 参考式的链接是在链接文字的方括号后再接上另一个方括号，并在第二个方括号中填入用以辨识链接的标记。而后在文件的任何位置将该标记进行定义。

可以通过[百度][bd]来查询

[bd]:http://www.baidu.com/"百度一下"

可以通过百度来查询

强调

Mrakdown使用*和底线_作为强调的标记字符。可以在需要强调的文字两边使用一个或两个强调标记符号将强调文字包住来使之强调。

*强调*

**强调**

_强调_

__强调__

强调

强调

强调

强调

但是，如果*或_两边都有空格的话会被当成普通符号，或背识别为其他标记。

*强调*

* 非强调 *

强调

• 非强调 *

代码

在Markdown中使用反引号`符号在行内标记代码。如果要在代码区使用反引号可以使用多个反引号将其标注。

使用`print()函数打印

应当用`` ` ``标注行内代码

使用print()函数打印

应当用`标注行内代码

图片

Maekdown使用和链接很像的方式来标记图片，同样可以分为行内式和参考式。

• 插入一个行内式图片标记，使用惊叹号!后面接内含有图片代替文字的方形括号[pic],其后再接一个内含有图片网址和选择性title的文字的圆括号()。

![pic](/path/img.jpg/"title")

• 插入一个参考式图片的语法则和插入参考式链接的方式很像。

![pic][p]

[p]:url/img.jpg/"title"

其他

表格

在Markdown中使用|来表示表格边界，使用-将表头和表格内容分开。

|1     |2     |3     |
|:----:|:----:|:----:|
|4     |5     |6     |

1	2	3
4	5	6

删除线

在Markdown中使用~~包围文字来插入删除线，且符号与文字之间不可以有空格。

~~删除线~~

删除线

注脚

在Markdown中使用[^注脚名]在文字处加注，然后在文件的任何地方添加同名脚注。

可以使用百度[^1]查询。

[^1]:http://www.baidu.com 

可以使用百度¹查询

锚点

Markdown中支持使用锚点的方法在文中跳转。应在使用跳转的地方加上跳转标记，而在要跳转到的地方加上跳转链接。但是Markdown只支持在标题中添加跳转链接。

#<span id =ml>目录</span>

跳转到[目录](#ml)

跳转到目录

自动链接

在Markdown中凡以方括号标记的网址或邮箱会自动标记成和链接一样。

[http://www.baidu.com]

[[email protected]]

[http://www.baidu.com]

[example.qq.com]

反斜杠

在Markdown中你可以使用反斜杠\来插入上面使用过的符号的符号实体。

参考文献

1.https://www.appinn.com/markdown/index.html

---

1. http://www.baidu.com↩