MarkDown官方语法笔记

360 阅读5分钟

Markdown语法笔记

Markdown是纯文本标记语言
HTML是超文本标记语言

目录

1.标题等级
2.段落,换行
3.文字强调(加粗,斜体)
4.块级引用
5.列表
6.图片
7.代码
8.分割线
9.超链接
10.转义字符
11.HTML
12.任务列表
13.对齐方式
14.表格

1.标题等级

N个#号后跟空格然后跟标题文字 最多六级。

还有种写法是在文字下方加大于两个==号即可把上面一行变为一级标题
加大于两个--号把上一行变为二级标题同时插入一条分割线
缺点是只能设置一整行

2.段落,换行

  • 分段,最好跟上面内容空一行出来
  • 折行:
    1. 在上一行尾部加两个空格(推荐)
    2. 在上一行尾部加一个反斜杠(缺点:如果下一行没内容,反斜杠就不会显示为换行)
    3. 连续空行不管多少,都会渲染成一行

3.文字强调(加粗,斜体)

  • 加粗:双星号包裹 或者双下划线包裹(不推荐)有的可能不支持行
  • 斜体:单星号包裹 或者单下划线包裹(不推荐)有的可能不支持
  • 加粗斜体:三星号包裹 或者三下划线包裹(不推荐)
  • 删除线:双波浪包裹
  • 颜色:只能用html标签
    • 我是黑体字

    • 我是微软雅黑

    • 我是华文彩云

    • 黑体

    • gray

    • null

      <font face="黑体">我是黑体字</font>
      <font face="微软雅黑">我是微软雅黑</font>
      <font face="STCAIYUN">我是华文彩云</font>
      <font color=#0099ff size=12 face="黑体">黑体</font>
      <font color=gray size=5>gray</font>
      <font color=#00ffff size=3>null</font>
      

4.块级引用

一个大于号开头,后跟一个空格然后跟内容

如果要换行需要前一行后跟两个空格折行,然后第二行也以大于号开头
最后一行的大于号无效

块内可再次引用

再次引用

与其他格式一起

5.列表

  1. 有序列表:
  2. 序号跟数字无关
    1. 数字后跟点,然后跟空格,再跟内容,
    2. 可以缩进
  • 无序列表:
    • 符号有-,*, +

    • 可以缩进

    • 同级不能混用

      中间如果插入段落的话,需要在当前等级的符号基础上,缩进四个空格,就可以作为引用插入

      可以结合其他符号,注意缩进

    • 又一行

6.图片

  • 格式:叹号跟方括号包裹图片名字,跟圆括号包裹图片链接
  • 示例: 测试图片

7.代码

  • 行间代码:包裹在倒引号之间let a = 123(横向数字键盘最左边按键)
  • 代码块:三个倒引号开始,后跟代码语言,跟代码块,最后以三个倒引号结束
        //js
        let a = 1;
        let b = 2;
        console.log(a + b)
    
        //swift
        let a: Int = 1
        let b: [String:Int] = [
            "aaa": 123
        ],
    

8.分割线

  • 三个*或者-或者下划线
  • 注意跟上下内容分别间隔一行

9.超链接

  • 行内式:方括号包裹文字,后跟圆括号包裹链接
    • 跟图片的区别是图片在方括号前面有个叹号
    • 百度
    • 鼠标放到链接上,会提示链接地址,可以在链接后加空格,跟双引号包裹的提示文字,即可显示提示文字百度
    • 快速创建超链接跟邮箱地址,直接大小括号包裹:www.baidu.com, mail@test.com
    • 可以对链接加粗斜,需要星号包裹整个链接 百度 (注意星号前后空格)
    • 为图片添加链接,把图片用方括号括起来,然后后面跟括号包裹的连接就行: 测试图片
      [![测试图片](https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1607016619584&di=3e0d1b6644971f2cf6633bfd3d1b5e74&imgtype=0&src=http%3A%2F%2Fup.bizhitupian.com%2Fpic_360%2Fc5%2F0d%2Fe1%2Fc50de1206b170ae491880937ff7f0d46.jpg)](https://www.baidu.com "这是提示")
      
  • 参考式 一般用在学术论文上,或者该链接被多次引用。文中写法:方括号包裹文字,后跟方括号包裹标记(数字或者别的文字,如果文字本身可以作为标记,可以直接写作:[文字][])百度, QQ
  • 注脚:文字后跟方括号包裹上箭头加注脚名字,然后再文字后方写注脚(方括号包裹的上箭头加注脚名字,跟冒号后加内容)1(貌似vscode不支持)
  • 锚点(内部链接):只有标题支持锚点,方括号包裹需要打锚点的文字后跟圆括号包裹的#加标题即可(注意#要跟标题一致且跟标题之间没有空格,标题要完全相同,有特殊字符需要转义)

10.转义字符

  • 前加斜杠,双斜杠表示转义斜杠。可以转义的字符:
    \ ` * _ {} [] () # + - . ! |
    特殊字符    描述	    字符的代码
                空格符	    &nbsp;
    <	        小于号	    &lt;
    >	        大于号	    &gt;
    &	        和号	    &amp;
    ¥           人民币	    &yen;
    ©	        版权	    &copy;
    ®	        注册商标	    &reg;
    °C	        摄氏度	    &deg;C
    ±	        正负号	    &plusmn;
    ×	        乘号	    &times;
    ÷	        除号	    &divide;
    ²	        平方(上标²)	    &sup2;
    ³	        立方(上标³)	    &sup3;

11.HTML

  • 直接内嵌:这是斜体
**直接**内嵌:<em>这是斜体</em>

12.任务列表

  • 未做: - [ ] 未做
  • 已做: - [x] 已做

13.对齐方式

左对齐

居中对齐

右对齐

<p align="left">左对齐</p> 
<p align="center">居中对齐</p>
<p align="right">右对齐</p>

14.表格

  • 竖线分隔,第一行是表头,第二行分割线是对应的三个横线
学号姓名序号
小明明5
小红79
小陆192
|学号|姓名|序号|
|-|-|-|
|小明明|男|5|
|小红|女|79|
|小陆|男|192|

Footnotes

  1. 12345