Markdown

1. 标题

写法一:

text
一级标题
==========
二级标题
----------

写法二:

text
# 一级标题
## 二级标题

注释:以此类推,#与标题间必须有空格

2. 段落

text
第一段

第二段

注释:markdown中段落间间距一行来表示不同段落

3. 文本样式

text
粗体    **粗体**
斜体    *斜体*
粗斜体  ***粗斜体***
-------------------
删除线  ~~删除文本~~
下划线  <u>下划线文本</u>

4. 分割线

text
1.---              分割线

2.回车              markdown直接回车换行即可,也可以在文本后加上两个空格来表示换行

3.```行内代码```    行内代码的写法

4.>内容             引用的写法 

5.[^1]:脚注         脚注创建写法

注释:1.markdown使用三个及以上"-"来表示分割线
	 2.在表格中换行,使用<br>标签
	 3.行内代码有多种写法,但三个`已经满足需求,记住这个就好
	 4.引用一方面美观,还可以起到和代码块相似的突出作用
	 5.脚注创建还有另一种写法,这里记住这个就行

5. 转义字符

text
\   反斜线

`   反引号

*   星号

_   下划线

{}  花括号

[]  方括号

()  小括号

#   井字号

+   加号

-   减号

.   英文句点

!   感叹号

注释:以上若想正常显示,在前面添加一个\即可

6. 列表

text
一、无序列表

- 项目1

- 项目2

- 项目3  

二、有序列表

1. 项目1

2. 项目2

3. 项目3
   
 三、任务列表

- [ ] 任务1

- [ ] 任务2

- [ ] 任务3
  • 注释:1. 列表可以互相嵌套,也可以放在别的内容里面 2. 列表书写注意空格

7. 表格

7.1 基本表格

text
|  表头   | 表头  |

|  ----  | ----  |

| 单元格  | 单元格 |

| 单元格  | 单元格 |

7.2 设置表格对齐方式

text
| 左对齐 | 右对齐 | 居中对齐 |

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

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

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

7.3 表格语法要求

  1. 表格的第一行是表头,用|分隔不同的单元格,每个单元格都需要有一个对齐方式

  2. "-"表示上下边框,"|"表示左右边框,左右边框不必严格对齐,数量对应即可

8. 链接

text
1. 行内链接:[链接文字](https://www.example.com)
   
		简单写法:<https://www.example.com>

2. 参考链接:[链接文字][1]

		[1]: https://www.example.com

8.1 锚点

text
文章锚点:

1. 行内锚点:[锚点文字](#锚点id)

2. 参考锚点:[锚点文字][1]

		[1]: #锚点id

手动创建锚点:

1. 在需要创建锚点的位置添加HTML标签:`<a id="锚点id"></a>`

2. 在文章中使用锚点:[锚点文字](#锚点id)

9. 图片

text
1. 行内图片:![图片描述](https://www.example.com/image.jpg)

2. 参考图片:![图片描述][1]

		[1]: https://www.example.com/image.jpg
  1. img标签写法:
html

<img src="https://www.example.com/image.jpg" alt="图片描述" />

  1. 点击图片跳转链接的markdown写法:
text
[![alt](图片URL)](链接URL)

注释

  • 对于路径,需要学习相关知识,图片和网址实际相同,都和"路径"相关
  • 中括号对应html里的alt属性,表示如果图片加载不出来的替代文本
  • 小括号对应html里的src属性,表示路径,需要填写相对路径/绝对路径,一般推荐相对路径

10. 数学公式渲染

数学公式渲染有以下几个主流工具

  • LaTex
  • KaTex
  • MathJax

LaTex不局限于一个公式渲染工具,而且是一个强大的排版工具 在vscode/trae……安装插件LaTex Workshop才能正常渲染markdown中的公式

  • 关于数学公式的书写语法,这里并不准备说明,可以借助AI来实现

11. Mermaid图表

11.1 流程图

mermaid
graph TD
    A[开始] --> B{条件判断}
    B -->|Yes| C[执行操作A]
    B -->|No| D[执行操作B]
    C --> E[结束]
    D --> E

11.2 时序图

mermaid
sequenceDiagram
    participant A as 用户
    participant B as 系统
    participant C as 数据库
    A->>B: 登录请求
    B->>C: 验证用户信息
    C-->>B: 返回验证结果
    B-->>A: 登录成功/失败

11.3 甘特图

mermaid
gantt
    title 项目开发计划
    dateFormat  YYYY-MM-DD
    section 设计阶段
    需求分析      :done,    des1, 2024-01-01,2024-01-15
    UI设计       :active,  des2, 2024-01-10, 30d
    section 开发阶段
    前端开发      :        dev1, after des2, 45d
    后端开发      :        dev2, 2024-02-01, 60d
    section 测试阶段
    单元测试      :        test1, after dev1, 15d
    集成测试      :        test2, after dev2, 10d

11.4 饼图

mermaid
pie
    title 浏览器市场份额
    "Chrome" : 65
    "Safari" : 15
    "Firefox" : 10
    "其他" : 10

11.5 序列图

mermaid
sequenceDiagram
    participant 用户
    participant 系统
    用户->>系统: 登录请求
    系统-->>用户: 验证请求
    用户->>系统: 提交凭证
    系统-->>用户: 登录成功

11.6 类图

mermaid
classDiagram
    class 用户 {
        +用户名: string
        +密码: string
        +登录()
    }
    class 订单 {
        +订单号: int
        +创建日期: date
        +计算总价()
    }
    用户 "1" --> "n" 订单

11.7 主题定制

mermaid
%%{init: {'theme': 'forest'}}%%
pie
    title 自定义主题
    "项目A" : 30
    "项目B" : 50
    "项目C" : 20

11.8 交互图表

mermaid
graph TD
    A[点击我] --> B[显示详细信息]
    click A "https://www.runoob.com" "这是提示文本"
  • 图表写法也借助AI生成即可
  • 有些图表在obsidian加载不出来,尚且不知道是什么问题