markdown 常用命令

生成目录

VS Code为markdown自动生成目录,并且解决目录不整齐问题

1.安装markdown toc 插件

15FFgO.jpg

2.更新目录及出现问题

15Fose.jpg
15kpLQ.jpg

3.解决方法

  • 点击页面左下角设置选项,进入用户设置界面。
  • 在用户设置页面搜索Eol。
  • 找到Eol后修改默认行尾字符为auto为\n。
  • 重新插入目录。
15kNOe.jpg
15kgOg.jpg

段落

  • md语言的段落由前后空行分割,强烈建议在所有的段落前后空行,减少语法特例的记忆量,保证输出样式正确性。

这是第一
个段落

这是第二个段落

这是第三个段落

标题

列举类atx式的规则,其他不做介绍。

# 一级
## 二级
### 三级
#### 四级

换行

  • 如果要实现换行需要在上一行结尾打两个Space加一个Enter。

    a b c
    ou

分隔线

1.一行连用三个或以上的'*'或'-'或'_'可以生成一条分隔线。使用'-'要注意前有空行,不然会和标题混淆。这些符号之间可以有空格。 分隔线上下为两个段落,无需段落前后空格。

列表与缩进

1.无序列表:用*或+或-在行首表示无序列表,在这些符号之后空一个格然后输入内容。

+ 无序列表
- 有序列表
* 缩进显示

显示为:

  • 无序列表
  • 有序列表
  • 缩进显示

2.列表嵌套

如果希望一个列表作为另一个列表的子项目同样可以使用Tab实现。源码之中使用什么符号和渲染结果没有直接关系,下面采用'*'举例。

* 吃饭
* 吃水果
    * 香蕉
    * 苹果
* 喝酒奶

显示为:

  • 吃水果
    • 香蕉
    • 苹果
  • 喝酒奶

3.有序列表:用数字加'.'在行首表示有序列表,在'.'后面加一个空格再写内容。

1. 有序列表
2. 无序列表
3. 缩进

显示为:

  1. 有序列表
  2. 无序列表
  3. 缩进

斜体与粗体

  • 使用一对'*'或'_'包围的内会显示为斜体。
  • 使用'**'或'__'包围的会显示为加粗。
  • 连续使用三个*或_表示为加粗斜体,也可分别用两种符号来表示。
这是*斜体*效果
这是**加粗**效果

***粗体且斜体***
**_粗体且斜体_**

显示为:
这是斜体效果
这是加粗效果

粗体且斜体
粗体且斜体

删除线

  • 使用双波浪线~~标识
  • 其他性质类似于粗体和斜体,并且可以嵌套。
~~这段删掉,不要了~~
~~_这段**整体**加粗_~~

显示为:
这段删掉,不要了
这段整体加粗

转义字符

  • md中用到可能有语法意义的非空白符号有:\ ` * _ {} [] () # * + - . ! 等(扩展语法中涉及到的符号请自动添加到此列)
  • 在正常段落中药原样输出以上符号,一般需要加反斜杠\在前。
  • 连续两个反斜杠输出一个反斜杠
\\
\`
\#
\*

显示为:

\
`
#
*

引用块

1.引用的效果就如本文档中代码和样式示例。在每行行首加'>'。

这是一则引用
若果想要保证实现多行,须在上一行结尾打两个Space加一个Enter。
两行之间存在空格的使用方法如下:

第一行内容

第三行内容

2.引用符号之后使用一次Tab和不使用的显示效果一样;>之后最多三个Space不会影响显示效果。

>   引用号之后使用一个Tab键,不会影响显示效果。
>    引用号之后使用三个以上的Space,影响显示效果。

显示为:

引用号之后使用一个Tab键,不会影响显示效果。

引用号之后使用三个以上的Space,影响显示效果。

3.引用嵌套,引用中可以使用其他样式。二级引用就是两个'>'连用,为了二级引用段落前后最好使用以及引用空行来标识开始和结束。

一级引用

二级引用

回到一级引用

再次二级引用
上边空行表示直接结束两级引用,不再从二级引用回到一级引用。

行内代码和代码段落

1.行内代码(使用反引号esc下面的键,单、双、多反引号都可以)

>这里插入一行代码`#include<stdio.h>`  
>另一行代码`123aoe`

显示为:

这里插入一行代码#include<stdio.h>
另一行代码123aoe

2.代码区块
方法之一:三个反引号"```"

student good  see much 

链接与图片

1.行内式链接:方括号中是链接文字,方括号后紧跟的圆括号内是地址,网址后空一格双引号引起来的是title文字,title文字可以不写。

下面例子中,在引用符号>后使用两个Tab键(只要引用符号>后面Space(空格键)超过三个,就会显示不同的引用效果)

[markdown](https://baike.baidu.com/item/markdown/3245829?fr=aladdin/ "百度百科")  

显示为:
markdown

2.参考式链接:参考式链接不在链接文字后直接写出,而是使用标记代表网站链接。下方代码中的id就是一个链接标记。链接标记需要定义。其定义位置比较灵活。但是推荐到文章最后或者最前,以方便查阅和修改。

 [markdown][id] 

 [id]: https://baike.baidu.com/item/markdown/3245829?fr=aladdin/ "百度百科"

显示为:

markdown

参考式链接中链接标记的定义:

  • 方括号,方括号写标记的名称
  • 英文的冒号
  • 冒号后面写地址
  • 地址后空一格写title标题,title标题可以不写。
  • title标题可以用双引号、单引号或者圆括号包围。
  • 地址可以用尖括号包围,也可以不用。
  • 注意!链接标签不区分大小写,指的是id。
    3.图片插入
  • 图片插入的格式实在链接的基础上进行变化的,并且同样有行内式和参考式。不同点:
    • 参考式的图片插入和行内式开头写'!'(英文标点),链接标记定义不需要。
    • 方括号内的链接文字不会显示,而是会被图片替换。

markdown插入图片,只能链接图片位置,图片本身并不在文本中保存,必须

![14wbSP.jpg](https://s2.ax1x.com/2020/02/10/14wbSP.jpg "风景图")

显示为:
14wbSP.jpg

  • 插入本地图片
    • 第一种保存于md文档一样的位置;
    • 第二种引入图片位置;

表格

表格由行列组成

  • 不同行之间用Enter分隔(不需要双空格)
  • 同行之间分隔不同列使用'|',行首和行尾也可以使用'|',并且推荐使用。
  • 同一张表格,各行的列数(单元格数)应该相同(没内容也要用空单元格补齐)
  • 一个表格的源代码第一行是表头,但是填写规则和普通单元格一样。
  • 一个表格源代码的第二行不会渲染成一行单元格,它被用来分隔表头和普通单元格。这一行每一个单元格都填写大于等于三个的'-'。
  • 在第二行的单元格还可以控制本列的对齐方式,规定:在'-'左侧加':'为左对齐;在'-'右侧加':'为右对齐;在'-'左右侧加':'为居中对齐;

示例:

lef-aligned center-aligned right-aligned
git status git status git status

显示为:

lef-aligned center-aligned right-aligned
git status git status git status