本文最后更新于 2024-10-16,文章内容距离上一次更新已经过去了很久啦,可能已经过时了,请谨慎参考喵。

title: MarkDown基础
tags:
  - MarkDown
  - Typora
categories:
  - 工具
top_img: false
cover: '/upload/cdn0files/20200721121154.jpg'
abbrlink: b797e99c
date: 2019-12-10 19:29:19
updated: 2019-12-10 19:29:19

介绍

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

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

3

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

4

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

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

安装

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

## 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,后面记得要加一个空格,并且会自动生成目录。

## 这是h1标题
#### 这是h3
####### 这是h6

效果如下:
10

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

引用内容

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

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

效果如下:
11

列表

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

### 无序
*   Red
*   Green
*   Blue

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

序号之后是有空格的哦

效果:
12

任务列表

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

### 未选中状态
- [ ] a task list item

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

效果如下:
13

代码块

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

(忽略我)```
代码在这里
(忽略我)``` 

效果如下:
效果

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

表格

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

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

效果:
效果

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

| First Header  | Second Header |
| ------------- | ------------- |
| Content Cell  | Content Cell  |
| Content Cell  | Content Cell  |

效果:效果

表格内容居中:

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

效果:
效果

脚注

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

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

效果:
效果

链接

对指定文字进行超链接:

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

效果:
效果

另一种链接:

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

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

效果:
效果

普通链接:

<https://www.laugh0608.online>

插入图片

代码:

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

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

例如:
效果

文字斜体和加粗

格式如下:

* 内容 *         //加粗
_ 内容 _         //斜体
*** 内容 ***     //斜体加粗

效果:
效果

其他通用语法

换行

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

删除线

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

 ~~ 内容 ~~ 

类似于这样:
15

转义符

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