Markdown学习记录

106 阅读6分钟

一级标题(下一行单独'=')

二级标题(下一行单独'-')

一级标题(#)

六级标题(最低级标题)(######)

注意符号和文字中间要空格才能成为标题

新段落

开启新段落的方法: 1:两个以上空格加回车
失败 2:两个回车

成功

字体

markdown通过符号夹文字来改变文字形式

*斜体文本*

_斜体文字_

**粗体文字**

__粗体文字__

****粗斜体文字***

___粗斜体文字___

分隔线

markdown使用三个以上'*'、'-'、'_'来显示分隔线,行中不能有其它内容,但可以在符号中穿插空格

***


- --


_ _ _


删除线

markdown通过在需要划线内容前后添加' ~~ '显示删除线

~~CONTENT~~ ===> CONTENT

下划线

markdown引用HTML的<u>显示下划线,引用</u>结束

<u>CONTENT</u>

脚注

markdown使*用[^脚注] 1*对文本内容2进行注释、补充说明。

注意后文必须使用同名 ' [^脚注]:注释内容' 才能启用前后标识,同时脚注语句必须换新行书写,阅读MD时注释内容会全程处于文件末尾分隔显示

列表

markdown支持无序列表与有序列表,符号和文字间隔

无序列表使用 ' * '、'+'、'-'作为列表标记 有序列表使用数字 + ' . '标记

  1. 第一行
  • *1.1
  • -1.2
  • +1.3
  1. 第二行
  2. 第三行但输入字符 '2',markdown会自行编号,即使输入错误编号也会顺序显示 4.1 但如果需要次级列表,则没有修正,必须正确填写编号
  • 一级实心圆
    • 空心圆(一个制表符)
      • 实心矩(两个制表符)
        • 实心矩(三个制表符,并不会变;同时有序列表使用制表符并不会有顺序变化,只会将制表符显出)
  1. a
    • b
    • c
    1. d
      • e

区块

markdown使用>'空格'内容来显示一块内容

> A > B > C

空一行跳出区块

>D不用每行都加 '>'

>F

>>不加空格也可以实现,但不如空格美观

>>> 多个 '>'实现嵌套

  1. > G
  1. 如果内嵌列表则必须规范书写,否则会跳出区块
  1. > H
  2. > I
  • > * J
    • > 制表符* K
  • > * L
  • > 制表符* M
  • > 制表符* N

代码

markdown使用 ' ` '包含进行标识

`COUT`

{
    代码区块使用一个制表符进入代码块
    在代码块中无法改变文本样式,前者区块中可以照常改变文本样式
}
也可以使用```(指定语言)代码块```包含

链接

通过链接名称跳转 [4399]后面紧跟(www.4399.com) ====> 4399

通过<链接>直接跳转 www.4399.com

图片

感叹号!+方括号[alt 属性文本]+普通括号(图片网址) alt jpg ![文本](s2.loli.net/2022/02/21/…)

表格

markdown使用 ' | ' 进行表格的标识

|表头|表头|

|----|----|

|单元格|单元格|

|单元格|单元格|

表头表头
单元格单元格
单元格单元格

可以在----栏使用: ' -: '友对齐 ' :- '左对齐 ' :-: ' 居中

|表头|表头|表头|

|:----|:----: |----: |

|单元格11111111|单元格2222222|单元格3333333|

|单元格|单元格|单元格|

表头表头表头
单元格11111111单元格2222222单元格3333333
单元格单元格单元格

ELSE

  1. markdown可以直接调用HTML标签进行设计
  2. 使用''转义字符显示特定符号,可以对以下符号使用

    \

    `

    *

    _

    {}

    []

    ()

    #

    +

    -

    .

    !

  3. VSCode插件Markdown Preview Enhanced使用KaTeX或MathJax渲染数学公式(暂时没有学习必要)
  4. 使用markdown进行图形绘制,使用代码格式

流程图 指定语言:mermaid

方向:graph LR 模板: A[方形] -->B(圆角) B --> C{条件a} C -->|a=1| D[结果1] C -->|a=2| E[结果2] F[横向流程图]

graph LR
    A[方形] -->B(圆角)
    B --> C{条件a}
    C -->|a=1| D[结果1]
    C -->|a=2| E[结果2]
    F[横向流程图]

方向:graph TD 模板:F[竖向流程图]

graph TD
A[方形] --> B(圆角)
    B --> C{条件a}
    C --> |a=1| D[结果1]
    C --> |a=2| E[结果2]
    F[竖向流程图]

以下在VSCode上面可以完整显示图例,但VSCode对教程中的甘特图无法显示;

标准流程图 指定语言:flow 模板: st=>start: 开始框 op=>operation: 处理框 cond=>condition: 判断框(是或否?) sub1=>subroutine: 子流程 io=>inputoutput: 输入输出框 e=>end: 结束框 st->op->cond cond(yes)->io->e cond(no)->sub1(right)->op

st=>start: 开始框
op=>operation: 处理框
cond=>condition: 判断框(是或否?)
sub1=>subroutine: 子流程
io=>inputoutput: 输入输出框
e=>end: 结束框
st->op->cond
cond(yes)->io->e
cond(no)->sub1(right)->op

横向 模板: st=>start: 开始框 op=>operation: 处理框 cond=>condition: 判断框(是或否?) sub1=>subroutine: 子流程 io=>inputoutput: 输入输出框 e=>end: 结束框 st(right)->op(right)->cond cond(yes)->io(bottom)->e cond(no)->sub1(right)->op

st=>start: 开始框
op=>operation: 处理框
cond=>condition: 判断框(是或否?)
sub1=>subroutine: 子流程
io=>inputoutput: 输入输出框
e=>end: 结束框
st(right)->op(right)->cond
cond(yes)->io(bottom)->e
cond(no)->sub1(right)->op

UML时序图 指定语言:sequence 模板: 对象A->对象B: 对象B你好吗?(请求) Note right of 对象B: 对象B的描述 Note left of 对象A: 对象A的描述(提示) 对象B-->对象A: 我很好(响应) 对象A->对象B: 你真的好吗?

对象A->对象B: 对象B你好吗?(请求)
Note right of 对象B: 对象B的描述
Note left of 对象A: 对象A的描述(提示)
对象B-->对象A: 我很好(响应)
对象A->对象B: 你真的好吗?

复杂样式 模板: Title: 标题:复杂使用 对象A->对象B: 对象B你好吗?(请求) Note right of 对象B: 对象B的描述 Note left of 对象A: 对象A的描述(提示) 对象B-->对象A: 我很好(响应) 对象B->小三: 你好吗 小三-->>对象A: 对象B找我了 对象A->对象B: 你真的好吗? Note over 小三,对象B: 我们是朋友 participant C Note right of C: 没人陪我玩

Title: 标题:复杂使用
对象A->对象B: 对象B你好吗?(请求)
Note right of 对象B: 对象B的描述
Note left of 对象A: 对象A的描述(提示)
对象B-->对象A: 我很好(响应)
对象B->小三: 你好吗
小三-->>对象A: 对象B找我了
对象A->对象B: 你真的好吗?
Note over 小三,对象B: 我们是朋友
participant C
Note right of C: 没人陪我玩

标准样式 指定语言:mermaid 模板: %% 时序图例子,-> 直线,-->虚线,->>实线箭头 sequenceDiagram participant 张三 participant 李四 张三->王五: 王五你好吗? loop 健康检查 王五->王五: 与疾病战斗 end Note right of 王五: 合理 食物
看医生... 李四-->>张三: 很好! 王五->李四: 你怎么样? 李四-->王五: 很好!

%% 时序图例子,-> 直线,-->虚线,->>实线箭头
    sequenceDiagram
    participant 张三
    participant 李四
    张三->王五: 王五你好吗?
    loop 健康检查
        王五->王五: 与疾病战斗
    end
    Note right of 王五: 合理 食物 <br/>看医生...
    李四-->>张三: 很好!
    王五->李四: 你怎么样?
    李四-->王五: 很好!

导出内容

ps:这个网站挺好用的

Footnotes

  1. 为什么会自动变为编号呢,如何显示自定义脚注内容?

  2. 编号就编号吧,不影响使用