
Markdown 入门到精通
之前图床服务出现问题导致图片无法加载,请见谅。
现在大多数帮助文档以及论坛都是由Markdown作为基础来编写的,Markdown有轻量化、易读写的特性,并且对图片、图表以及数学公式都有支持,语法特别简单,而且排版贼好,不像word那样动不动就出错,官方网站的教程不是很清楚明了,所以打算写这篇文章。
这个笔记的作用是记录学习的过程,另外就是忘了还可以拿来复习。
Markdown 简单说明
Markdown
几乎是目前互联网上最流行的写作语言。
Markdown
编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。
Markdown
学习成本低,常用的语法很少,只有几种符号,简单易学快速上手。
例如: GitHub、CSDN、简书、掘金、博客园、知乎等。
Markdown 工具
Markdown
常用的编写工具有Typora(收费)
、VSCode(免费)
、Obsidian(免费)
等工具,整体结构都差不多,Typora
属于用户是最多的,后面我会写一个关于Typora
的破解教程。
Markdown 语法
标题
标题使用#
号标记,可以表示1-6级标题, 随#
的个数递增,一级标题字号最大,六级标题字号最小。
代码如下:
1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
效果:
PS:
#
字符要加一个空格后在输入标题标题应该置于行首,如果放入表格中可能无法正确解析
字体
星号与下划线都可以,单是斜体,双是粗体,三是粗斜体
代码 | 效果 |
---|---|
*这是斜体* |
这是斜体 |
_这是斜体_ |
这是斜体 |
**这是粗体** |
这是粗体 |
__这是粗体__ |
这是粗体 |
***这是粗斜体*** |
这是粗斜体 |
___这是粗斜体___ |
这是粗斜体 |
PS:加粗Ctrl+B 斜体Ctrl+I
列表
- 无序列表:使用星号 * 、加号 + 或减号 - ,效果一致
- 有序列表:使用数字 1、2、3 等,并加上英文句号 .
1
2
3
4
5
6
7
* 无序列表 1
+ 无序列表 2
- 无序列表 3
1. 有序列表 1
2. 有序列表 2
3. 有序列表 3
效果:
- 无序列表 1
- 无序列表 2
- 无序列表 3
- 有序列表 1
- 有序列表 2
- 有序列表 3
- 控制层级:符号星号 * 、加号 + 或减号 - 前使用 tab
效果:1
2
3
4* 无序列表 1 + 无序列表 2 - 无序列表 2.1 * 无序列表 2.2
- 无序列表 1
- 无序列表 2
- 无序列表 2.1
- 无序列表 2.2
链接 / 图片链接
原始链接:<链接地址>
文字链接:[链接名称] (链接地址)
1
2
原始链接:<https://sawr.gitee.io>
文字链接:[奥奥の探索日记](https://sawr.gitee.io/)
效果:
文字链接:奥奥の探索日记
图片
- 图片链接:![链接名称] (链接地址 “title”)
1

效果:
复制的图片直接Ctrl+V粘贴过来更为快捷。
引用
- 一层引用:一个右尖括号 >
- 二层引用:两个右尖括号 >
- N 层引用:N 个右尖括号 >
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
一层引用
> 二层引用
>> 三层引用
```
效果:
一层引用
> 二层引用
>> 三层引用
---
### 分隔线
- 【三个以上】星 * 或减号 -
```html
---
***
* * ****
- - - ----
```
效果:
---
***
* * ****
- - - ----
### 删除线
- 删除文字前后添加【两个】~
```html
~~我是一个很可怜不幸被删除的文字~~
```
效果:
~~我是一个很可怜不幸被删除的文字~~
### 下划线
- 下划线文字前后添加< u >< u />
- 下划线使用了HTML中的标签
```html
<u>我是一个带有下划线的文字</u
效果:
我是一个带有下划线的文字
表格
分隔列:使用竖线 |
分隔行:使用减号 -
对齐位置:冒号 : 位置决定对齐位置
左对齐::-
右对齐:-:
居中对齐::-:
1
2
3
4
5
6
单词 | 音标 | 翻译
:- | :-: | -:
|aunt|/eɪnt/|姨母;姨母 姑母;伯母;婶母|
|brother|/brʌðər/|兄;弟|
|cousin|/ˈkʌzən/|堂(表)兄弟;堂(表)姐妹|
|couple|/ˈkʌpl/|夫妇|
单词 | 音标 | 翻译 |
---|---|---|
aunt | /eɪnt/ | 姨母;姨母 姑母;伯母;婶母 |
brother | /brʌðər/ | 兄;弟 |
cousin | /ˈkʌzən/ | 堂(表)兄弟;堂(表)姐妹 |
couple | /ˈkʌpl/ | 夫妇 |
上表格中
:- | :-: | -:
分别表示 第一列左对齐,第二列剧中,第三列右对齐,所以可能会有一些怪异,仅仅演示效果。
脚注
- 脚注:文本右上角备注
- 尾注:文末备注内容
脚注:文本[^注脚名字]
尾注:[^数字]:文本解释
1
2
3
4
5
微软[^1]
[^1]: 微软(Microsoft)是一家跨国电脑科技公司,成立于 1975 年,由比尔·盖茨和保罗·艾伦创立。
GitHub[^2]
[^2]:https://www.github.com/
效果:暂不支持。
微软[^1]
[^1]:微软(Microsoft)是一家跨国电脑科技公司,成立于 1975 年,由比尔·盖茨和保罗·艾伦创立。
GitHub[^2]
[^2]:https://www.github.com/
代码
行内代码:内容前后【一个】反引号 `
1
一个著名的搜索引擎:`www.baidu.com`
效果:
一个著名的搜索引擎:
www.baidu.com
块内代码:内容前后【三个】反引号**
1
2
3
4
5
6
7
8
9
10- 在首行\`\`\`后加上编程语言 如`js` ```js // 定义一个函数,用于输出 "Hello, World!" function sayHello() { console.log("Hello, World!"); } // 调用 sayHello 函数 sayHello();
Markdown 高级语法
插入目录
输入内容[TOC]
即可出现目录,例如:
[TOC]
HTML语法
Markdown支持原生HTML语法,通过内联样式书写即可。
文字效果:
1
<h2 style='text-shadow: 10px 5px 5px red'>你好呀,欢迎来学习</h2>
你好呀,欢迎来学习
一个圆角正方形
1
<div style='border:1px solid green;width:130px;height:130px;border-radius:30px;background:black;'/>
表格
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
<table>
<tr>
<th rowspan="2">课程表</th>
<th>星期一</th>
<th>星期二</th>
<th>星期三</th>
<th>星期四</th>
<th>星期五</th>
</tr>
<tr>
<td>语文</td>
<td>数学</td>
<td>英语</td>
<td>英语</td>
<td>英语</td>
</tr>
</table>
课程表 | 星期一 | 星期二 | 星期三 | 星期四 | 星期五 |
---|---|---|---|---|---|
语文 | 数学 | 英语 | 英语 | 英语 |
复选框
Markdown也支持写待办任务事项,语法也是特别简单
TODOLIST : - [x/X]
和 - [ ]
1
2
- [x] 表示选中状态
- [ ] 表示未选中状态
- 表示选中状态
- 表示未选中状态
数学公式
$$表示一整行的公式
1
2
$ax + b = 0$
$a² + b² = c²$
例如:
名称 | 公式 | 解释 |
---|---|---|
二元一次方程 | $ax + b = 0$ | 这是一个含有两个未知数 x 和 y 的一次方程。 |
勾股定理 | $a² + b² = c²$ | 勾股定理描述了直角三角形的三边长度关系。 |
流程图
代码属性是mermaid
,使用时添加上即可,测试为了方便所以采用了json格式显示。
例子:
1
2
3
4
5
graph TD;
A(爷爷)-->B(爸爸);
A-->C(叔叔);
B-->D(大郎);
B-->E(二郎);
时序图
代码属性是mermaid
,使用时添加上即可,测试为了方便所以采用了json格式显示。
效果:
1
2
3
4
5
graph LR;
A(爷爷)-->B(爸爸);
A-->C(叔叔);
B-->D(大郎);
B-->E(二郎);
结语
这篇文章,写了整整一个下午,内容全为干货,最快的时间来上手Markdown
。
如果有没写到的,欢迎补充。
有些功能没有展示出来,是因为有些技术难关还没有攻克,等待攻克技术难关了就可以显示了。
一起学习,一起努力。