Markdown 语法学习文档
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
井号加空格，可以生成标题格式；几个井号就是几级标题# 一级标题## 二级标题### 三级标题
常见问题
如果你发现你的 Markdown 无法正常使用，有可能是因为以下几个原因
- 没有在英文输入法下使用符号
- 部分笔记软件并不支持所有的 Markdown 语法，例如 Notion 不支持
==高亮==语法 - 部分编辑器需要进入
设置中开启特定的 Markdown 语法，例如 Typora 就需要手动开启 高亮 功能
列表
有序列表
英文输入法下，数字后面加一点，然后空格
- AAA
1. AAA - BBB
2. BBB - CCC
3. CCC
无序列表
1. 有三种语法符号，三种都可以2. 但更推荐使用短横杠，因为不需要使用组合键
- AAA
- AAA
- BBB
+ BBB
- CCC
* CCC
列表的互相嵌套
基础语法：
- 一个回车可以使列表递进，两个回车可以取消自动列表
- 使用 tab 可以使列表缩进，使用 shift +tab 可以取消列表缩进
有序和无序列表的互相嵌套：
- 按 回车 生成列表第二项
- 按 tab 缩进列表
- 再按 回车 取消列表第二项
- 然后使用有序或者无序列表的基础语法即可
字体标记
所有符号都需要在英文输入法下
- 加粗
**加粗** 删除~~删除~~- 斜体
*斜体* - 高亮
==高亮==
注：部分笔记软件对 Markdown 的支持不够完全，可能只支持 加粗
段落相关
- 引用语法
> 这是一段引用
这是一段引用
- 分割线
--- ; 三个或以上的短横杠，然后回车
代码
行内代码
x`行内代码` ；这个符号的位置在数字键 1 左边的那个小点上，注意需要在英文输入法下使用
可以在一句话中的任意位置使用 行内代码 语法
代码块
基础语法：
```1. 在英文输入法下，输入三个小点 `2. 部分笔记软件可以直接回车3. 其他笔记软件则需要手动在末尾补上三个小点```xxxxxxxxxx$(document).ready(function () { alert('eryi');});xxxxxxxxxxfrom settings import worldif world == 'mine': kept = keep(world)xxxxxxxxxxlet myWorld = "Hello World"print(myWorld)
超链接
基础链接用法
xxxxxxxxxx[百度](www.baidu.com)
示例：百度
高级链接用法
两种使用场景：
- ① 在文稿起草阶段，还没确定具体网址，但可以先给出网址标题
- ② 同一篇文章需要重复出现同一个网址时
使用方法：
xxxxxxxxxx1. 格式 ：[网址标题][变量01]2. 在文档最后解释变量[变量01]:www.baidu.com
示例：
脚注
语法：
xxxxxxxxxx这是一句需要添加脚注的话[^01][^01]:这是放在文档最底下，用来解释脚注的内容
示例：
图片
基础语法
xxxxxxxxxx1. 基本格式：2. 示例：3. 图片链接可以是本地链接，也可以是在线链接
图床
什么是图床
所谓的图床就是用来在线存放图片的地方，可以理解为专门用来存放图片的网盘。图床上的每一张图片都能够生成一个唯一的访问链接，使用这个链接，任何人都能够在线读取你的图片。
为什么你可能会需要图床
- 因为 Markdown 编辑器的文档无法内嵌图片，所有图片都以
的形式写在 Markdown 文档内，如果这里的「图片链接」使用的是本地图片的链接，那么当你分享这一个 Markdown 文档、或者你自己在别的地方打开这个 Markdown 文档时，文档里的图片就无法正常显示了。 - 所以需要将图片上传到图床，生成一个可以在线访问的图片链接后，在任意地方分享、打开这个 Markdown 文件，所有的图片就都能正常显示
如何搭建图床
由于本文的主旨仍是 Markdown 的语法教学，所以就不在此处介绍过多的图床搭建教程，但你可以在我的 个人博客 阅读这篇 图床搭建教程 ，整个过程非常简单，无需任何代码基础，只是需要一点点小小的耐心。
表格
基础语法：
xxxxxxxxxx| 表头 | 表头 || ---- | ---- || 单元格 | 单元格 || 单元格 | 单元格 |
表格对齐：
- 左对齐：
:---- - 居中对齐：
:----: - 右对齐：
----:
xxxxxxxxxx| 左对齐 | 居中对齐 | 右对齐 || :----|:----:|----:|| AAA | BBB | CCC |
| 左对齐 | 居中对齐 | 右对齐 |
|---|---|---|
| AAA | BBB | CCC |
图表
注意：
- 不是所有的 Markdown 编辑器都支持图表语法
- 由于要完全学会这些语法，起码要厚厚一本书的教程长度，所以本文仅做展示
- 并且其实我并不推荐用 Markdown 语法去画图表，你有更好的工具去实现这类需求，没必要舍近求远
- 如果你实在感兴趣的话，可以访问学习 Github 的这个开源项目 → Mermaid 语法
①
xxxxxxxxxx```mermaidgraph LRA[方形] -->B(圆角)B --> C{条件a}C -->|a=1| D[结果1]C -->|a=2| E[结果2]F[横向流程图]```
②
xxxxxxxxxx```mermaidgraph TDA[方形] --> B(圆角)B --> C{条件a}C --> |a=1| D[结果1]C --> |a=2| E[结果2]F[竖向流程图]```
③
xxxxxxxxxx```sequence对象A->对象B: 对象B你好吗?（请求）Note right of 对象B: 对象B的描述Note left of 对象A: 对象A的描述(提示)对象B-->对象A: 我很好(响应)对象A->对象B: 你真的好吗？```
④
xxxxxxxxxx```mermaid%% 时序图例子,-> 直线，-->虚线，->>实线箭头sequenceDiagramparticipant 张三participant 李四张三->王五: 王五你好吗？loop 健康检查王五->王五: 与疾病战斗endNote right of 王五: 合理 食物 <br/>看医生...李四-->>张三: 很好!王五->李四: 你怎么样?李四-->王五: 很好!```
⑤
xxxxxxxxxx```mermaid%% 语法示例ganttdateFormat YYYY-MM-DDtitle 软件开发甘特图section 设计需求 :done, des1, 2014-01-06,2014-01-08原型 :active, des2, 2014-01-09, 3dUI设计 : des3, after des2, 5d未来任务 : des4, after des3, 5dsection 开发学习准备理解需求 :crit, done, 2014-01-06,24h设计框架 :crit, done, after des2, 2d开发 :crit, active, 3d未来任务 :crit, 5d耍 :2dsection 测试功能测试 :active, a1, after des3, 3d压力测试 :after a1 , 20h测试报告 : 48h```
Comments
Post a Comment