markdown一些常用、实用写法记录
用markdown写博客和README应该算是IT人的基本素养吧,记录些实用的写法,总有用到的时候
基础语法
| 语法 | 语义 | 栗子 |
|---|---|---|
| #,##,###... | 1,2,3...级标题 | # title |
| ' \n'(双空格+回车) | 文本换行 | 第一行 (双空格) 第二行 |
| 1.,2.,3.,... | 有序列表,数字其实可以重复, tab缩进控制子列表 |
1. 2. 1. 1. 3. |
| -或*或+ | 无序列表 同样缩进控制子列表 |
- f1 - s1 - s2 - f2 |
| ** ** | 粗体 | **txt** |
| * * | 斜体 | *txt* |
| ~~ ~~ | ~~txt~~ | |
| ` ` | 行内代码 |
`txt` |
| ```language ``` |
块代码 |
```javascript console.log("1") ``` |
| > | 内联块 | > block same block > block2 |
| ---或***或___ | 分割线,需要三个以上 且前面行为空 |
--- 这是第三行 |
| [ ]( ) | 跳转链接 | [链接](url) |
|  |  | |
| | | | | 表格 | | 表头1 | 表头2 | 表头3 | | :--- | ---: | :---: | | 左对齐 | 右对齐 | 居中 | |
进阶语法
- md中没有文字下划线的语法,但是可以用
<u>这个html标签实现,<u>txt</u> - Table of content,[TOC], 生成文档目录这个语法有些平台是不能兼容的,它的左右就是将文档里的#这类title生成一个带锚点的列表,所以如果不兼容,其实本质上我们可以自定义一个列表然后添加锚点,但是这么做显然不够方便。
有一个插件,叫doctoc,如果右node,可以用npm全局安装,其他方式也行
然后对需要生成目录的文件run一下就行了,不过每次#这类标题有改动时,就要重新生成一次npm i -g doctocdoctoc README.md - 锚点,上面也提到了锚点,那么锚点怎么写呢?
- 在html中,我们写锚点就是给需要跳转的dom一个id,然后给一个href=id或者在url里跟#id就能跳转,其实markdown里差不多,不过也是要跳转#相关的标题,如:点击这里回到基础语法,写法就是连接,但是()括号里的内容是#title,如:[跳转](#基础语法)

浙公网安备 33010602011771号