MarkDown基本用法记录

1.顶级标题,通常指文章标题,在下面一行加上====(至少2个)

2.二级标题,通常指文章的子标题,在下面一行加上---
【注】以上两种标题格式,也可以用#号来标注,但是#必须在行首才能生效,并且#越多,标题级别月底,至多6个#号,# 标题

3.分割线,3个以上的*或者-或者_即可____

4.如果使用下划线“_”必须在前面加反斜杠\,类似于\_

5.代码片的插入,前后利用```符号封装即可,是Esc下方的那个按钮,同时MarkDown支持高亮显示,只要在开头的```后面跟上语言类型即可,比如```java,后面的```则不需要加任何东西

6.粗体,将需设置粗体的内容用两个*即可**待加粗内容**

7.缩进,缩进两个空格可以用 缩进一个空格用 

8.换行,直接两下回车即可,或者两下空格键再回车即可,或者在后面追加</br>

9.斜体,前后用*包裹即可*带斜字体*

10.插入图片,![图片id,可缺省](图片路径 "鼠标悬停显示的内容,可缺省")在打开md文件编写的时候,图片就不要移动、重命名之类的操作,否则无法读取图片信息,路径间用正斜杠/!不能跨磁盘!,同级目录可省直接写图片名即可,否则一直写所在:…/目录3/所在目录2/所在目录1/图片名。一直到md文件所在的同级目录即可

11.无序列表,可以用*+-后面跟空格即可*

12.有序列表,直接数字加句号加空格1.依次向后推即可,如果有序列表很多,而且比较懒,那么可以在1.之后的列表直接用*代替无需写具体序号,MarkDown会自动编号

13.网络链接,[描述的文字](网址)例如:[百度](http://www.baidu.com)

14.引用内容,> 引用内容,>符号必须放在行首

15.插入表格,各列之间用管道符|隔开,然后第一行写表头字段名,第二行写格式(内容用占位符-表示即可),第三行之后开始写表格的主题内容,总体格式如下:
【注意】默认表格内容是左对齐,可以通过第二行在对应列的占位符左右加:改变对齐方式,在-左边加就是左对齐,在后边加就是右对齐,两边加就是居中,如果不能渲染,请和上面的内容空出一行的内容

TableHeadr1 | TableHeader2 | TableHeader3
- | - | -
Content11 | Content12 | Content13
Content21 | Content22 | Content23
Content31 | Content32 | Content33

上面的展示效果如下:

TableHeadr1 TableHeader2 TableHeader3
Content11 Content12 Content13
Content21 Content22 Content23
Content31 Content32 Content33

当然除了上面的方式,也可以利用html中的写法,不过有些麻烦,比如:

<table> 
    <th>TableHeader1</th>
    <th>TableHeader2</th>
    <th>TableHeader3</th>
    <tr>
        <td>Content11</td>
        <td>Content12</td>
        <td>Content13</td>
    </tr>
        <tr>
        <td>Content21</td>
        <td>Content22</td>
        <td>Content23</td>
    </tr>
        <tr>
        <td>Content31</td>
        <td>Content32</td>
        <td>Content33</td>
    </tr>
</table>

渲染效果如下

TableHeader1 TableHeader2 TableHeader3
Content11 Content12 Content13
Content21 Content22 Content23
Content31 Content32 Content33

16.插入上、下标,这里是利用html标签来实现的,上标用<sup>上标</sup>包裹即可,下标用<sub>下标</sub>包裹即可

17.删除线,用~~包裹内容即可,比如

~~删除的内容~~

展现的效果如下:删除的内容

18.特殊符号比如<>如果中间没有内容可以显示<和>符号,但是如果中间有内容(指以英文字符开头的内容)的话在MarkDown中是无法显示的,甚至<和>符号都会消失,这个时候<必须写成&lt;而>可以直接写;如果在使用&发现显示错误,那必须改写为&amp;

19.引用,直接在内容前面加上>即可,效果如下:

这里是引用的内容

20.链接到本文指定地方,这里我使用的是html语法,在需要链接的内容使用<span id="xx">进行标记,然后在链接关键字上进行链接即可,看一下具体语法:
[链接1](#lj1)
<span id=lj1>链接1的内容</span>

实现的效果如下:点我回文章开头

21.根据小节生成文章目录,这点其实就是第11点和第20点的结合,提取文章的每个标题使用列表进行一级、二级标题的合理排列,然后将每个标题链接到各自对应的地方即可,唯一不同的是这里不需要使用<span>标记了,使用###等形成的标题本身就是id,所以可以直接使用,注意子级标题的点好必须省略,标题中的空格使用-代替。比如下面的

* [1. 一级标题一](#1-一级标题一)
    * [1.1 二级标题一](#11-二级标题一)
    * [1.2 二级标题二](#12-二级标题二)
* [2. 一级标题二](#2-一级标题二)
    * [2.1 二级标题三](#21-二级标题三)
    * [2.2 二级标题四](#22-二级标题四)

## 1. 一级标题一

&emsp;内容一……

### 1.1 二级标题一

&emsp;内容二……

### 1.2 二级标题二

&emsp;内容三……

## 2. 一级标题二

&emsp;内容四……

### 2.1 二级标题三

&emsp;内容五……

### 2.2 二级标题四(

&emsp;内容一六……

下面就是上述代码实现的效果:

1. 一级标题一

 内容一……注意1.一级标题一之间是有一个空格的,个人书写习惯,你也可以不留空格。

1.1 二级标题一

 内容二……

1.2 二级标题二

 内容三……

2. 一级标题二

 内容四……

2.1 二级标题三

 内容五……

2.2 二级标题四

 内容一六……

【注意】人工提取标题有些麻烦,推荐VSC客户端使用markdownlint插件,然后在需要生成目录的地方右击选择Markdown TOC:insert/update即可生成目录,很便捷

猜你喜欢

转载自blog.csdn.net/jacksonary/article/details/79153287
今日推荐