Markdown 使用及语法

博主： Dwtowen
发布时间：2019 年 09 月 23 日
584次浏览
暂无评论
7050字数
分类：技术技巧学习笔记

# Markdown 使用及语法

# 基本技巧

## 一、标题

在想要设置为标题的文字前面加#来表示

一个#是一级标题，二个#是二级标题，以此类推。支持六级标题。

`注：标准语法一般在#后跟个空格再写文字。`

示例：

```
# 这是一级标题

## 这是二级标题

### 这是三级标题

#### 这是四级标题

##### 这是五级标题

###### 这是六级标题
```

效果如下：

# 这是一级标题

## 这是二级标题

### 这是三级标题

#### 这是四级标题

##### 这是五级标题

###### 这是六级标题

## 二、字体

* 加粗
  
  要加粗的文字左右分别用`两个*号`包起来
* 斜体
  
  要倾斜的文字左右分别用`一个*号`包起来
* 斜体加粗
  
  要倾斜和加粗的文字左右分别用`三个*号`包起来
* 删除线
  
  要加删除线的文字左右分别用`两个~~号包`起来

示例：

```
**这是加粗的文字**

*这是倾斜的文字*`

***这是斜体加粗的文字***

~~这是加删除线的文字~~
```

效果如下：

**这是加粗的文字**

*这是倾斜的文字*`

***这是斜体加粗的文字***

~~这是加删除线的文字~~

## 字体颜色

```
$\color{red}{red}$
```

效果：$\color{red}{red}$

```
$\color{green}{green}$
```

效果：$\color{green}{green}$

```
$\color{blue}{blue}$
```

效果：$\color{blue}{blue}$

```
$\color{#376956}{cyan-blue}$
```

效果：$\color{#376956}{cyan-blue}$

**句子中的字加颜色**

```
$\color{#4285f4}{更}\color{#ea4335}{丰}\color{#fbbc05}{富}\color{#4285f4}{的}\color{#34a853}{颜}\color{#ea4335}{色}$
```

效果：$\color{#4285f4}{更}\color{#ea4335}{丰}\color{#fbbc05}{富}\color{#4285f4}{的}\color{#34a853}{颜}\color{#ea4335}{色}$

```
$\color{#4285f4}{G}\color{#ea4335}{o}\color{#fbbc05}{o}\color{#4285f4}{g}\color{#34a853}{l}\color{#ea4335}{e}$
```

效果：$\color{#4285f4}{G}\color{#ea4335}{o}\color{#fbbc05}{o}\color{#4285f4}{g}\color{#34a853}{l}\color{#ea4335}{e}$

**另外添加颜色的方式**

```
我是黑体字
我是微软雅黑
我是华文彩云

color=#0099ff size=72 face="黑体"
color=#00ffff
color=gray
```

我是黑体字
我是微软雅黑
我是华文彩云

color=#0099ff size=72 face="黑体"

color=#00ffff

color=gray

## 三、引用

在引用的文字前加`>`即可。

引用也可以嵌套，如加两个》>三个》>> n 个。.. 貌似可以一直加下去，但没神马卵用

示例：

```
>这是引用的内容

>>这是引用的内容

>>>>>>>>>>这是引用的内容
```

效果如下：

> 这是引用的内容

> > 这是引用的内容

> >

> > > > > > > > > > 这是引用的内容

## 四、换行

### 另起一行

只需在`当前行结尾`加 `2个空格`

### 新起一行

如果是要起一个新段落，只需要`空出一行`即可。

# 五、分割线

`三个或者三个以上`的 `- 或者 *` 都可以。

示例：

```
---

----

***

*****
```

## 效果如下：

---

## 六、图片

语法：

```
![图片alt](图片地址 ‘‘图片title‘‘)

图片alt就是显示在图片下面的文字，相当于对图片内容的解释。

图片title是图片的标题，当鼠标移到图片上时显示的内容。title可加可不加
```

示例：

```
![head_portrait](https://cdn.jsdelivr.net/gh/dengwentong/wallpaper_zero/2k/14.jpg "head_portrait")
```

![head_portrait](https://cdn.jsdelivr.net/gh/dengwentong/wallpaper_zero/2k/14.jpg "head_portrait")

## 七、超链接

语法：

```
[超链接名](超链接地址 "超链接title")

title可加可不加
```

示例：

```
[Dwtowen's Blog](https://blog.dwtowen.com/)

[邓文通的个人博客](https://blog.dwtowen.com/)
```

效果如下：

[Dwtowen's Blog](https://blog.dwtowen.com/)

[邓文通的个人博客](https://blog.dwtowen.com/)

## 八、列表

### 无序列表

语法：无序列表用 `- + *` 任何一种都可以

```
- 列表内容

+ 列表内容

* 列表内容
```

`注意：- + * 跟内容之间都要有一个空格`

效果如下：

* 列表内容
* 列表内容
* 列表内容

### 有序列表

语法：`数字加点`

```
1. 列表内容

1. 列表内容

1. 列表内容
```

`注意：序号跟内容之间要有空格`

`注意：不要求数字一定要连续，可以都是1.`

效果如下：

1. 列表内容
2. 列表内容
3. 列表内容

#### 列表嵌套

上一级和下一级之间敲`三个空格`即可

```
- 一级无序列表内容

- 二级无序列表内容

- 一级无序列表内容

- 二级无序列表内容

- 二级无序列表内容
```

效果如下：

* 一级无序列表内容
* 二级无序列表内容
* 二级无序列表内容
* 二级无序列表内容
* 一级无序列表内容
* 二级无序列表内容
* 二级无序列表内容
* 二级无序列表内容

## 九、表格

语法：

```
列之间以 | 分隔,

第二行分割表头和内容。

标题与文本之间以 - 分隔, 用:表示显示位置,

文字默认居左

:-表示靠左显示,

:-:居中显示,

-:靠右显示

注：- 有一个就行，为了对齐，多加了几个

注：原生的语法两边都要用 | 包起来。此处省略
```

```
| Tables | Are | Cool |
| :--- | :---: | ---: |
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
```

效果如下：

| Tables | Are | Cool |
| :--- | :---: | ---: |
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |

# 十、脚注

在要添加注释的词语后面增加 `[^1]` , 结尾加入 [^1]：空格 注释内容

```
hello[^1]

[^1]: hi
```

点击保存后的效果：

hello[^1]

# 十一、 目录

用`[TOC]`生成目录，自动把文档中带#标题生成目录

# 十二、代码

语法：

单行代码

\`代码内容`

多行代码

\```

代码内容

\```

效果如下：

#### 单行

\`create database hero;`

`create database hero;`

#### 多行

\```js

function fun(){

echo "这是一句非常牛逼的代码";

}

fun();

\```

```js
function fun(){

echo "这是一句非常牛逼的代码";

}

fun();
```

#### 代码高亮

如果你只想高亮语句中的某个函数名或关键字，可以使用 `function_name()` 实现

通常编辑器根据代码片段适配合适的高亮方法，但你也可以用 ``` 包裹一段代码，并指定一种语言

```js
$(document).ready(function () {

alert(‘hello world‘);

});
```

支持的语言：

```js
1c, abnf, accesslog, actionscript, ada, apache, applescript, arduino,

,armasm, asciidoc, aspectj,

,autohotkey, autoit, avrasm, awk, axapta, bash, basic, bnf, brainfuck,

,cal, capnproto, ceylon, clean,

,clojure, clojure-repl, cmake, coffeescript, coq, cos, cpp, crmsh,

,crystal, cs, csp, css, d, dart, delphi,

,diff, django, dns, dockerfile, dos, dsconfig, dts, dust, ebnf, elixir,

,elm, erb, erlang, erlang-repl,

,excel, fix, flix, fortran, fsharp, gams, gauss, gcode, gherkin, glsl,

,go, golo, gradle, groovy

,haml, handlebars, haskell, haxe, hsp, htmlbars, http, hy, inform7

, ini, irpf90, java, javascript,

,json, julia, kotlin, lasso, ldif, leaf, less, lisp, livecodeserver,

,livescript, llvm, lsl, lua,

,makefile, markdown, mathematica, matlab, maxima, mel,

,mercury, mipsasm, mizar, mojolicious,

,monkey, moonscript, n1ql, nginx, nimrod, nix, nsis,

,objectivec, ocaml, openscad, oxygene,

,parser3, perl, pf, php, pony, powershell, processing,

,profile, prolog, protobuf, puppet,

,purebasic, python, q, qml, r, rib, roboconf, rsl, ruby,

,ruleslanguage, rust, scala, scheme, scilab,

,scss, smali, smalltalk, sml, sqf, sql, stan, stata, step21,

,stylus, subunit, swift, taggerscript, tap,

,tcl, tex, thrift, tp, twig, typescript, vala, vbnet, vbscript,

,vbscript-html, verilog, vhdl, vim,

,x86asm, xl, xml, xquery, yaml, zephir
```

也可以使用 `4 空格缩进`，再贴上代码，实现相同的的效果

```js
def g(x):

yield from range(x, 0, -1)

yield from range(x)
```

如你不需要代码高亮，可以用下面的方法禁用：

\```nohighlight

function fun(){

}

\```

```nohighlight
function fun(){

echo "这是一句非常牛逼的代码";

}

fun();
```

# 高级技巧

## 一 行内 HTML 元素

目前只支持部分段内 HTML 元素效果，包括 `<kdb> ` ，如

### 键位显示

使用 Ctrl+Alt+Del 重启电脑

### 代码块

使用 `<pre></pre>` 元素同样可以形成代码块

### 粗斜体

` Markdown 在此处同样适用，如 *加粗* `

**Markdown 在此处同样适用，如 *加粗***

### 符号转义

如果你的描述中需要用到 markdown 的符号，比如 _ # * 等，但又不想它被转义，这时候可以在这些符号前加反斜杠，如 _ # * 进行避免。

```
\_不想这里的文本变斜体\_

\*\*不想这里的文本被加粗\*\*
```

## 二 扩展

支持 `jsfiddle、gist、runjs、优酷视频`，直接填写 url，在其之后会自动添加预览点击会展开相关内容。

```
http://{url_of_the_fiddle}/embedded/[{tabs}/[{style}]]/

https://gist.github.com/{gist_id}

http://runjs.cn/detail/{id}

http://v.youku.com/v_show/id_{video_id}.html
```

http://{url_of_the_fiddle}/embedded/[{tabs}/[{style}]]/

[https://gist.github.com/{gist_id}](https://gist.github.com/%7Bgist_id%7D)

[http://runjs.cn/detail/{id}](http://runjs.cn/detail/%7Bid%7D)

[http://v.youku.com/v_show/id_{video_id}.html](http://v.youku.com/v_show/id_%7Bvideo_id%7D.html)

End Thanks！👶

最后修改：2021 年 04 月 28 日 10 : 09 AM

如果觉得我的文章对你有用，请随意赞赏

发表评论取消回复

评论 *

私密评论

名称 *

🎲

邮箱 *

地址

看透一切的女孩
求
歪比歪比
麻烦大大分享下，谢谢
XJ
emmm，请问现在能访问吗，我这是可以的
XJ
网站名：Zhang的个人分享网站网站链接：https://zk...
Vincent
就是这个问题，困扰了我好久，终于解决了！

Markdown 使用及语法

Dwtowen • 2019 年 09 月 23 日

# Markdown 使用及语法

# 基本技巧

## 一、标题

在想要设置为标题的文字前面加#来表示

一个#是一级标题，二个#是二级标题，以此类推。支持六级标题。

`注：标准语法一般在#后跟个空格再写文字。`

示例：

```
# 这是一级标题

## 这是二级标题

### 这是三级标题

#### 这是四级标题

##### 这是五级标题

###### 这是六级标题
```

效果如下：

# 这是一级标题

## 这是二级标题

### 这是三级标题

#### 这是四级标题

##### 这是五级标题

###### 这是六级标题

## 二、字体

示例：

```
**这是加粗的文字**

*这是倾斜的文字*`

***这是斜体加粗的文字***

~~这是加删除线的文字~~
```

效果如下：

**这是加粗的文字**

*这是倾斜的文字*`

***这是斜体加粗的文字***

~~这是加删除线的文字~~

## 字体颜色

```
$\color{red}{red}$
```

效果：$\color{red}{red}$

```
$\color{green}{green}$
```

效果：$\color{green}{green}$

```
$\color{blue}{blue}$
```

效果：$\color{blue}{blue}$

```
$\color{#376956}{cyan-blue}$
```

效果：$\color{#376956}{cyan-blue}$

**句子中的字加颜色**

```
$\color{#4285f4}{更}\color{#ea4335}{丰}\color{#fbbc05}{富}\color{#4285f4}{的}\color{#34a853}{颜}\color{#ea4335}{色}$
```

效果：$\color{#4285f4}{更}\color{#ea4335}{丰}\color{#fbbc05}{富}\color{#4285f4}{的}\color{#34a853}{颜}\color{#ea4335}{色}$

```
$\color{#4285f4}{G}\color{#ea4335}{o}\color{#fbbc05}{o}\color{#4285f4}{g}\color{#34a853}{l}\color{#ea4335}{e}$
```

效果：$\color{#4285f4}{G}\color{#ea4335}{o}\color{#fbbc05}{o}\color{#4285f4}{g}\color{#34a853}{l}\color{#ea4335}{e}$

**另外添加颜色的方式**

```
我是黑体字
我是微软雅黑
我是华文彩云

color=#0099ff size=72 face="黑体"
color=#00ffff
color=gray
```

我是黑体字
我是微软雅黑
我是华文彩云

color=#0099ff size=72 face="黑体"

color=#00ffff

color=gray

## 三、引用

在引用的文字前加`>`即可。

引用也可以嵌套，如加两个》>三个》>> n 个。.. 貌似可以一直加下去，但没神马卵用

示例：

```
>这是引用的内容

>>这是引用的内容

>>>>>>>>>>这是引用的内容
```

效果如下：

> 这是引用的内容

> > 这是引用的内容

> >

> > > > > > > > > > 这是引用的内容

## 四、换行

### 另起一行

只需在`当前行结尾`加 `2个空格`

### 新起一行

如果是要起一个新段落，只需要`空出一行`即可。

# 五、分割线

`三个或者三个以上`的 `- 或者 *` 都可以。

示例：

```
---

----

***

*****
```

## 效果如下：

---

## 六、图片

语法：

```
![图片alt](图片地址 ‘‘图片title‘‘)

图片alt就是显示在图片下面的文字，相当于对图片内容的解释。

图片title是图片的标题，当鼠标移到图片上时显示的内容。title可加可不加
```

示例：

```
![head_portrait](https://cdn.jsdelivr.net/gh/dengwentong/wallpaper_zero/2k/14.jpg "head_portrait")
```

![head_portrait](https://cdn.jsdelivr.net/gh/dengwentong/wallpaper_zero/2k/14.jpg "head_portrait")

## 七、超链接

语法：

```
[超链接名](超链接地址 "超链接title")

title可加可不加
```

示例：

```
[Dwtowen's Blog](https://blog.dwtowen.com/)

[邓文通的个人博客](https://blog.dwtowen.com/)
```

效果如下：

[Dwtowen's Blog](https://blog.dwtowen.com/)

[邓文通的个人博客](https://blog.dwtowen.com/)

## 八、列表

### 无序列表

语法：无序列表用 `- + *` 任何一种都可以

```
- 列表内容

+ 列表内容

* 列表内容
```

`注意：- + * 跟内容之间都要有一个空格`

效果如下：

* 列表内容
* 列表内容
* 列表内容

### 有序列表

语法：`数字加点`

```
1. 列表内容

1. 列表内容

1. 列表内容
```

`注意：序号跟内容之间要有空格`

`注意：不要求数字一定要连续，可以都是1.`

效果如下：

1. 列表内容
2. 列表内容
3. 列表内容

#### 列表嵌套

上一级和下一级之间敲`三个空格`即可

```
- 一级无序列表内容

- 二级无序列表内容

- 一级无序列表内容

- 二级无序列表内容

- 二级无序列表内容
```

效果如下：

## 九、表格

语法：

```
列之间以 | 分隔,

第二行分割表头和内容。

标题与文本之间以 - 分隔, 用:表示显示位置,

文字默认居左

:-表示靠左显示,

:-:居中显示,

-:靠右显示

注：- 有一个就行，为了对齐，多加了几个

注：原生的语法两边都要用 | 包起来。此处省略
```

```
| Tables | Are | Cool |
| :--- | :---: | ---: |
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
```

效果如下：

| Tables | Are | Cool |
| :--- | :---: | ---: |
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |

# 十、脚注

在要添加注释的词语后面增加 `[^1]` , 结尾加入 [^1]：空格 注释内容

```
hello[^1]

[^1]: hi
```

点击保存后的效果：

hello[^1]

# 十一、 目录

用`[TOC]`生成目录，自动把文档中带#标题生成目录

# 十二、代码

语法：

单行代码

\`代码内容`

多行代码

\```

代码内容

\```

效果如下：

#### 单行

\`create database hero;`

`create database hero;`

#### 多行

\```js

function fun(){

echo "这是一句非常牛逼的代码";

}

fun();

\```

```js
function fun(){

echo "这是一句非常牛逼的代码";

}

fun();
```

#### 代码高亮

如果你只想高亮语句中的某个函数名或关键字，可以使用 `function_name()` 实现

通常编辑器根据代码片段适配合适的高亮方法，但你也可以用 ``` 包裹一段代码，并指定一种语言

```js
$(document).ready(function () {

alert(‘hello world‘);

});
```

支持的语言：

```js
1c, abnf, accesslog, actionscript, ada, apache, applescript, arduino,

,armasm, asciidoc, aspectj,

,autohotkey, autoit, avrasm, awk, axapta, bash, basic, bnf, brainfuck,

,cal, capnproto, ceylon, clean,

,clojure, clojure-repl, cmake, coffeescript, coq, cos, cpp, crmsh,

,crystal, cs, csp, css, d, dart, delphi,

,diff, django, dns, dockerfile, dos, dsconfig, dts, dust, ebnf, elixir,

,elm, erb, erlang, erlang-repl,

,excel, fix, flix, fortran, fsharp, gams, gauss, gcode, gherkin, glsl,

,go, golo, gradle, groovy

,haml, handlebars, haskell, haxe, hsp, htmlbars, http, hy, inform7

, ini, irpf90, java, javascript,

,json, julia, kotlin, lasso, ldif, leaf, less, lisp, livecodeserver,

,livescript, llvm, lsl, lua,

,makefile, markdown, mathematica, matlab, maxima, mel,

,mercury, mipsasm, mizar, mojolicious,

,monkey, moonscript, n1ql, nginx, nimrod, nix, nsis,

,objectivec, ocaml, openscad, oxygene,

,parser3, perl, pf, php, pony, powershell, processing,

,profile, prolog, protobuf, puppet,

,purebasic, python, q, qml, r, rib, roboconf, rsl, ruby,

,ruleslanguage, rust, scala, scheme, scilab,

,scss, smali, smalltalk, sml, sqf, sql, stan, stata, step21,

,stylus, subunit, swift, taggerscript, tap,

,tcl, tex, thrift, tp, twig, typescript, vala, vbnet, vbscript,

,vbscript-html, verilog, vhdl, vim,

,x86asm, xl, xml, xquery, yaml, zephir
```

也可以使用 `4 空格缩进`，再贴上代码，实现相同的的效果

```js
def g(x):

yield from range(x, 0, -1)

yield from range(x)
```

如你不需要代码高亮，可以用下面的方法禁用：

\```nohighlight

function fun(){

}

\```

```nohighlight
function fun(){

echo "这是一句非常牛逼的代码";

}

fun();
```

# 高级技巧

## 一 行内 HTML 元素

目前只支持部分段内 HTML 元素效果，包括 `<kdb> ` ，如

### 键位显示

使用 Ctrl+Alt+Del 重启电脑

### 代码块

使用 `<pre></pre>` 元素同样可以形成代码块

### 粗斜体

` Markdown 在此处同样适用，如 *加粗* `

**Markdown 在此处同样适用，如 *加粗***

### 符号转义

如果你的描述中需要用到 markdown 的符号，比如 _ # * 等，但又不想它被转义，这时候可以在这些符号前加反斜杠，如 _ # * 进行避免。

```
\_不想这里的文本变斜体\_

\*\*不想这里的文本被加粗\*\*
```

## 二 扩展

支持 `jsfiddle、gist、runjs、优酷视频`，直接填写 url，在其之后会自动添加预览点击会展开相关内容。

```
http://{url_of_the_fiddle}/embedded/[{tabs}/[{style}]]/

https://gist.github.com/{gist_id}

http://runjs.cn/detail/{id}

http://v.youku.com/v_show/id_{video_id}.html
```

http://{url_of_the_fiddle}/embedded/[{tabs}/[{style}]]/

[https://gist.github.com/{gist_id}](https://gist.github.com/%7Bgist_id%7D)

[http://runjs.cn/detail/{id}](http://runjs.cn/detail/%7Bid%7D)

[http://v.youku.com/v_show/id_{video_id}.html](http://v.youku.com/v_show/id_%7Bvideo_id%7D.html)

End Thanks！👶

Markdown 使用及语法

发表评论取消回复

7zip批量压缩文件夹批量打包

Typecho评论邮件提醒插件-CommentToMail - 美化版

Typecho发布动态/说说的时间不对，往后了8小时

CentOS安装远程桌面通过Windows远程桌面RDP mstsc 直接访问

Windows最新官方原版系统ISO镜像下载

Windows Terminal 简单美化

IIS安装SSL证书实现HTTPS访问

MacBook 关闭开机自动启动 Android File Transfer

分手后还可以做朋友吗？

My Visual Studio Code Extensions

Markdown 使用及语法

发表评论 取消回复

Markdown 使用及语法

发表评论取消回复