Markdown使用

项目名称

运维培训

文件名称

Markdown使用

编制部门

后台运维

作者

刘珂

当前版本

201807171552

受众范围

后台运维

文档控制

修改记录

日期

版本

修改类型

修改主要内容

作者

◆修改类型:A增加、B删除、C修改

审阅人

姓名

部门

职位

审阅签字

审阅时间

存档

存档时间

存放方式

存放地点、位置

备注

◆存放方式:A电子、B纸质

目录

1 VScode写markdown 1

2 Markdown语法 2

2.1 标题 2

2.2 段落 3

2.3 列表 3

2.4 代码 4

2.5 分隔线 4

2.6 链接 5

2.7 强调 5

2.8 引用 5

2.9 图片 6

  1. VScode写markdown

打开vscode,新建文件保存为.md后缀。

输入

# 文档主题

## 二级标题

正文abcd....

### 三级标题

[链接](http://example.net/) 链接.

*强调*

_强调_

**强调**

代码

Use the `printf()` function.

引用

## 这是一个标题。

1. 这是第一行列表项。

2. 这是第二行列表项。

给出一些例子代码:

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

按Ctrl Shift p,输入preview,找到下面的Preview,回车。

  1. Markdown语法

参考:

https://www.zybuluo.com/mdeditor

http://markdownpad.com/

https://www.appinn.com/markdown/

效果图:

Markdown展示时其实被渲染成了html。

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

(1)类 Setext 形式是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题),例如:

This is an H1

=============

This is an H2

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

任何数量的 = 和 - 都可以有效果。

(2)类 Atx 形式则是在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶,例如:

# 这是 H1

## 这是 H2

###### 这是 H6

(3)你可以选择性地「闭合」类 atx 样式的标题,这纯粹只是美观用的,若是觉得这样看起来比较舒适,你就可以在行尾加上 #,而行尾的 # 数量也不用和开头一样(行首的井字符数量决定标题的阶数):

# 这是 H1 #

## 这是 H2 ##

### 这是 H3 ######

一个 Markdown 段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行。

换行需要敲两次enter。

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

  1. 无序列表使用*/+/-(星号、加号或是减号)作为列表标记:

* Red

* Green

* Blue

等同于:

+ Red

+ Green

+ Blue

也等同于:

- Red

- Green

- Blue

  1. 有序列表则使用数字接着一个英文句点:

1. Bird

2. McHale

3. Parish

  1. 列表项目标记通常放在最左边,但其实也可以缩进,最多 3 个空格,项目标记后面一定要接着至少一个空格或制表符。

* 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.

Suspendisse id sem consectetuer libero luctus adipiscing\.

代码块

缩进 4 个空格或是 1 个制表符或是```包围:

```

hello world

```

这是一个普通段落:

这是一个代码区块。

代码

Use the `printf()` function.

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

* * *

***

*****

- - -

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

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

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

星号*和底线_作为标记强调字词的符号

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

(1)普通

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 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.

(2)嵌套

This is the first level of quoting.

This is nested blockquote.

Back to the first level.

(3)引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等:

## 这是一个标题。

1. 这是第一行列表项。

2. 这是第二行列表项。

给出一些例子代码:

return shell\_exec\("echo $input | $markdown\_script"\);

![Alt text](/path/to/img.jpg)

![Alt text](/path/to/img.jpg "Optional title")

详细叙述如下: