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)
![ ]( ) 图片 ![图片描述](图片资源url)
| | | 表格 | 表头1 | 表头2 | 表头3 |
| :--- | ---: | :---: |
| 左对齐 | 右对齐 | 居中 |

进阶语法

  • md中没有文字下划线的语法,但是可以用<u>这个html标签实现,<u>txt</u>
  • Table of content,[TOC], 生成文档目录这个语法有些平台是不能兼容的,它的左右就是将文档里的#这类title生成一个带锚点的列表,所以如果不兼容,其实本质上我们可以自定义一个列表然后添加锚点,但是这么做显然不够方便。
    有一个插件,叫doctoc,如果右node,可以用npm全局安装,其他方式也行
    npm i -g doctoc
    
    然后对需要生成目录的文件run一下就行了,不过每次#这类标题有改动时,就要重新生成一次
    doctoc README.md
    
  • 锚点,上面也提到了锚点,那么锚点怎么写呢?
    • 在html中,我们写锚点就是给需要跳转的dom一个id,然后给一个href=id或者在url里跟#id就能跳转,其实markdown里差不多,不过也是要跳转#相关的标题,如:点击这里回到基础语法,写法就是连接,但是()括号里的内容是#title,如:[跳转](#基础语法)
posted @ 2022-06-20 16:56  Mizuki-Vone  阅读(44)  评论(0)    收藏  举报