介绍

​ MarkDown格式应该是一个程序员必备的技能了吧,是我们在写作的一大利器。支持Markdown格式的编辑器也很多,我经常使用的就只有VScode和Typora,这两个算是各有优缺点。

​ VScode的预览格式是在右边单独分出来一栏来进行实时预览写作效果,左边还是代码部分,效果如下:

3

而Typora的预览是直接在本文档生成文档效果,结果如下:

4

具体效果可以自己去试试哦,之前一直用着VScode但是碍于屏幕较小,分成两个屏幕有些东西预览的时候不好看效果,后来经过同事推荐,才知道Typora这个超级轻量的编辑器,而且也支持Linux、Windows和Mac。

所以本篇文章是基于Typora来写markdown语法的,但是语法是通用的哦,除了一些特有的功能

安装

我用的是基于Ubuntu的Linux发行版,所以安装很简单:

1
2
3
4
5
6
7
8
9
10
11
12
13
## sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys BA300B7755AFCFAE

wget -qO - https://typora.io/linux/public-key.asc | sudo apt-key add -

## add Typora's repository

sudo add-apt-repository 'deb https://typora.io/linux ./'

sudo apt-get update

## install typora

sudo apt-get install typora

或者下载源码进行编译安装,其他安装方式请参考:

特有功能和配置

主题

Typora支持非常多的主题,甚至可以自己去设计属于自己的主题。

5

这里是官方的主题:http://theme.typora.io/

6

在这里可以根据官方文档进行自己安装、配置和制作主题

7

特有配置

在设置里可以自己自定义非常多关于自己的喜好设置

8
9

更多请自己去探索哦,真的很强大。

在新版Typora里可以设置图片通过PicGo一键上传图床功能,很方便呢

语法

标题

标题是用”#”号来进行标记的,一个代表h1到六个代表h6,后面记得要加一个空格,并且会自动生成目录。

1
2
3
## 这是h1标题
#### 这是h3
####### 这是h6

效果如下:
10

注意左边的大纲里也会生成相应的目录哦

引用内容

我们经常需要引用一些东西,格式如下

1
2
3
> 这里是提示内容
>>> 增加缩进引用
>>>>>>> 数量不受限制

效果如下:11

列表

列表分为无序和有序列表,格式分别为:

1
2
3
4
5
6
7
8
9
10
### 无序
* Red
* Green
* Blue

### 有序
1. Red
2. Green
3. Blue

序号之后是有空格的哦

效果:12

任务列表

任务列表就是内容前面加上勾选的选项,显示这个任务的状态。

1
2
3
4
5
6
### 未选中状态
- [ ] a task list item

### 选中状态
- [x] completed

效果如下:13

代码块

代码块的符号,就是键盘上ESC下面那个键,和波浪线是同一个键,就是” `` “这个符号,格式:

1
2
3
```
代码在这里
​```

效果如下:效果

单行代码只用一个反引号包住代码即可。

表格

表格比较复杂,标记符号就是通道符” | “,格式如下:

1
| 第一格 | 第二格 | 第三格 |

效果:效果

标准格式:虚线上方为标题栏:

1
2
3
4
| First Header  | Second Header |
| ------------- | ------------- |
| Content Cell | Content Cell |
| Content Cell | Content Cell |

效果:效果

表格内容居中:

1
2
3
4
5
6
| Left-Aligned  | Center Aligned  | Right Aligned |
| :------------ |:---------------:| -----:|
| col 3 is | some wordy text | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |

效果:
效果

脚注

脚注是指当鼠标移动到该单词时显示对该词的注释,格式如下

1
2
You can create footnotes like this[^footnote].
[^footnote]: Here is the *text* of the **footnote**.

效果:效果

链接

对指定文字进行超链接:

1
[This link](http://example.net/)

效果:效果

另一种链接:

1
2
3
This is [an example][id] reference-style link.

[id]: http://example.com/ "Optional Title Here"

效果:效果

普通链接:

1
<https://www.laugh0608.online>

插入图片

代码:

1
2
![Alt text](/path/to/img.jpg)
![Alt text](/path/to/img.jpg "Optional title")

既可以引用本地文件,但是更推荐使用图床工具,即使是图片链接也可以实时预览哦 前提是你要有网

例如:效果

文字斜体和加粗

格式如下:

1
2
3
* 内容 *         //加粗
_ 内容 _ //斜体
*** 内容 *** //斜体加粗

效果:
效果

其他通用语法

换行

在Typora里换行直接可以敲一个回车即可,但是在其他编辑器或者Github里,换行是有严谨的格式的,就是每一个段落的后面必须加上两个空格和一个回车才能换行,或者说中间空一行。例如:
14

删除线

有时候我们需要删除一些东西,但是又不能完全删除,还需要一些参考意义,就可以使用到删除线:

1
~~ 内容 ~~ 

类似于这样:
15

转义符

文字缩进空格是不行的,因为空格和tab在markdown里都是标记,所以要用到转义符,所有的转义符都可以使用HTML格式:
16