Marrkdown基础用法

前言

因为著名的2/8原则，这里只列出最常见的一些用法，特殊的用法、不常用的用法、炫酷的效果、语法糖等可以通过搜索引擎得到想要的答案，毕竟动手的知识掌握得更加深刻。

markdown简介

Markdown是一种可以使用普通文本编辑器编写的标记语言，通过简单的标记语法，它可以使普通文本内容具有一定的格式。它允许人们使用易读易写的纯文本格式编写文档，然后转换成格式丰富的HTML页面，Markdown文件的后缀名便是“.md”

用法列表

标题

字符效果和横线

引用

锚点与链接

代码高亮

图片

有序列表&无序列表

表格

特殊符号处理

标题

标题的语法很简单：#号加上空格后面接标题名称

# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

实际效果：

字符效果和横线

只用记住最简单的*号个数就行了，使用下划线_能达到同样的效果

 *斜体*  或者  _斜体_

 **加粗**  或者  __加粗__

 ***斜体加粗***  或者 ___斜体加粗___

 ~~删除~~

实际效果：

一条横线：  ----------

实际效果：

换行：

<br/>

实际效果：会换行空出一行

引用

  >引用内容会自动缩进

  >引用的嵌套

  >>嵌套引用

实际效果：

锚点与链接

链接：

链接：

[普通链接](https://www.mdeditor.com/)

[普通链接带标题](https://www.mdeditor.com/ "普通链接带标题")

直接链接：<https://www.mdeditor.com>

实际效果：

锚点：

用html的语法

在指定位置定义了一个：<a name="divtop"></a>

我们跳转过去：[跳转指定位置](#divtop)

这种用法不一定有用

代码高亮

单行代码：`npm install marked`

实际效果：

单行代码：npm install marked

多行代码：用```三个反引号前后包裹代码,

如果要语法高亮就在```后面加小写语言名,eg:html,css,javascript,python,cs(csharp)等等

```

    fun (x: Int, y: Int): Int {

     return x + y;

    }

```

实际效果：

    fun (x: Int, y: Int): Int {

     return x + y;

    }

图片

图片的语法和链接类似，只是在前面加上了!感叹号

  ![图片标题](d:\images\a.png)

  ![图片标题](d:\images\a.png "为所欲为")

实际效果：

有序列表&无序列表

无序列表：* - + 效果一致

* 列表项1

* 列表项2

- 列表项1

- 列表项2

+ 列表项1

+ 列表项2

实际效果：

列表项1
列表项2

嵌套的无序列表：

+ 列表一

+ 列表二

    + 列表二-1

    + 列表二-2

    + 列表二-3

+ 列表三

    * 列表一

    * 列表二

    * 列表三

实际效果：

列表一
列表二
- 列表二-1
- 列表二-2
- 列表二-3
列表三
- 列表一
- 列表二
- 列表三

有序列表：会从你输入的最小数字开始自动增加排序

1. 列表项1

2. 列表项2

实际效果：

列表项1
列表项2

表格

表格语法比较复杂，建议直接复制粘贴拿来用就行

|xxx|xxx|

|---|---|

|xxx|xxx|

实际效果：

xxx	xxx
xxx	xxx

特殊符号与颜色处理

Markdown使用反斜杠\插入语法中用到的特殊符号，不转义将导致内容显示不全，甚至排版混乱，要有以下几种特殊符号需要处理：

\   反斜线

`   反引号

*   星号

_   底线

{}  花括号

[]  方括号

()  括弧

#   井字号

+   加号

-   减号

.   英文句点

!   惊叹号

使用方法：如果要显示反斜线，输入两个\\即可

字体加颜色：

红色：<font color='#ff0000'>红色</font>

其他颜色类似

实际效果：

红色

ps：其他的效果，例如check List，html特殊字符，科学公式，流程图，时序图等不作为基础语法，需要的时候再去查就OK了~

markdown进阶技巧

如果你只是想试试markdown语法的实际效果，用在线编辑markdown的网站就可以实时查看效果:markdown在线编辑

如果想用markdown作为写作的便捷语法（尤其是作家、程序员等），强烈推荐使用宇宙第一IDE Vitual Studio Code作为写markdwon文档的工具，毕竟IDE能够提高生产力，配合下载vscode的插件markdown-all-in-one

能够所见即所得(如果vscode插件不能实时搜索到，请参考这篇文章离线安装插件：vscode离线安装插件方法)

vscode写markdown有一些代码提示，快捷键等，不展开详细讲，感兴趣可以自己去搜索；

markdown插件有一个生成和更新目录的功能：

按F1，然后输入 ctoc，能生成目录；

按F1，输入 utoc 就会更新目录，更新过一次后，你以后Ctrl+S就会自动更新目录

参考文章