生成目录
VS Code为markdown自动生成目录,并且解决目录不整齐问题
1.安装markdown toc 插件
2.更新目录及出现问题
3.解决方法
- 点击页面左下角设置选项,进入用户设置界面。
- 在用户设置页面搜索Eol。
- 找到Eol后修改默认行尾字符为auto为\n。
- 重新插入目录。
段落
- md语言的段落由前后空行分割,强烈建议在所有的段落前后空行,减少语法特例的记忆量,保证输出样式正确性。
这是第一
个段落
这是第二个段落
这是第三个段落
标题
列举类atx式的规则,其他不做介绍。
# 一级
## 二级
### 三级
#### 四级
换行
-
如果要实现换行需要在上一行结尾打两个Space加一个Enter。
a b c
ou
分隔线
1.一行连用三个或以上的'*'或'-'或'_'可以生成一条分隔线。使用'-'要注意前有空行
,不然会和标题混淆。这些符号之间可以有空格。 分隔线上下为两个段落,无需段落前后空格。
列表与缩进
1.无序列表:用*或+或-在行首表示无序列表,在这些符号之后空一个格
然后输入内容。
+ 无序列表
- 有序列表
* 缩进显示
显示为:
- 无序列表
- 有序列表
- 缩进显示
2.列表嵌套
如果希望一个列表作为另一个列表的子项目同样可以使用Tab实现。源码之中使用什么符号和渲染结果没有直接关系,下面采用'*'举例。
* 吃饭
* 吃水果
* 香蕉
* 苹果
* 喝酒奶
显示为:
- 吃水果
- 香蕉
- 苹果
- 喝酒奶
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/ "百度百科"
显示为:
参考式链接中链接标记的定义:
- 方括号,方括号写标记的名称
- 英文的冒号
- 冒号后面写地址
- 地址后
空一格
写title标题,title标题可以不写。 - title标题可以用双引号、单引号或者圆括号包围。
- 地址可以用尖括号包围,也可以不用。
- 注意!链接标签不区分大小写,指的是id。
3.图片插入 - 图片插入的格式实在链接的基础上进行变化的,并且同样有行内式和参考式。不同点:
- 参考式的图片插入和行内式开头写'!'(英文标点),链接标记定义不需要。
- 方括号内的链接文字不会显示,而是会被图片替换。
markdown插入图片,只能链接图片位置,图片本身并不在文本中保存,必须
![14wbSP.jpg](https://s2.ax1x.com/2020/02/10/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 |