奥奥の探索日记
ShaoAo
文章18
标签19
分类6

文章分类

Markdown 入门到精通

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. 有序列表 1
  2. 有序列表 2
  3. 有序列表 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/)

效果:

原始链接:https://sawr.gitee.io

文字链接:奥奥の探索日记


图片

  • 图片链接:![链接名称] (链接地址 “title”)
    1
    ![神奇的图片名字](https://tucdn.wpon.cn/2023/08/29/ab1ebc2d0c3f4.jpg)

效果:
神奇的图片名字

复制的图片直接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

如果有没写到的,欢迎补充。

有些功能没有展示出来,是因为有些技术难关还没有攻克,等待攻克技术难关了就可以显示了。

一起学习,一起努力。


本文作者:ShaoAo
本文链接:https://sawr.gitee.io/2023/08/29/tools/markdown/
版权声明:本文采用 CC BY-NC-SA 3.0 CN 协议许可,仅作个人记录,转载请说明出处!