markdown的使用

[TOC]
# markdown

#### 什么是markdown？

- markdown是一种语法，在纯文本上加注特殊符号，让文本具有一定的格式，用于文字排版。

- markdown语法分为基本语法和增强语法

- 基本语法：文字排版
  - 增强语法：能扩展markdown的功能，如表格，脚注，内嵌HTML，数学公式，代码高亮，流程图

- markdown需要编辑器来渲染出语法效果

- 各种编辑器支持基本语法，但对增强型的语法的支持各有不同

- 编辑器有在线的，有PC端的，有手机端的；有免费的，也有收费的。有开源的，也有不开源的。
    - 在线的markdown编辑器

| 在线编辑器                                                   | 特点                                     |
    | ------------------------------------------------------------ | ---------------------------------------- |
    | https://www.zybuluo.com/mdeditor                             | 支持markdown基本语法和增强语法<br>不开源 |
    | http://bh-lay.github.io/mditor/                              | 仅支持markdown基本语法<br>开源           |
    | https://lab.lepture.com/editor/<br>https://github.com/lepture/editor | 仅支持markdown最基本语法<br>开源         |
    | https://ui.toast.com/tui-editor/<br>https://github.com/nhnent/tui.editor | 功能强大<br/>开源                        |

- PC端的markdown编辑器

| PC端编辑器 | 下载地址                     | 特点               |
    | ---------- | ---------------------------- | ------------------ |
    | 作业部落   | https://www.zybuluo.com/cmd/ | 部分免费，部分收费 |
    | typora     | https://www.typora.io/       | 免费！             |

#### 为什么要使用markdown?

- 比起word来，markdown有以下优点
  - 排版简洁，整齐
  - 生成的轻量级的文件，比word的要小很多
  - 增强的markdown功能多，能高亮代码，支持数学公式，书写流程图等

- 各大平台都支持用markdown撰写文章
  - CSDN，简书，github
    - 微信，知乎（需转换工具）
  - 各大平台对markdown的语法支持力度不同
    - 简书，知乎不支持目录；CSDN支持目录

#### typora和markdown

- typora是一款客户端的markdown编辑器
- Typora目前支持3个系统：Mac OS X, Linux和Windows，其中Windows版本有64位和32位

# 题目

##### 标题

- 语法

```
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
```

技巧：1.标准的语法是井号和标题内容之间要有一个空格，typora中没有空格也没关系，但是csdn中不行

2. 把光标放在标题行任意位置，ctrl + 0【typora】

##### 目录

- 语法

```
[toc]
```

# 隔离

##### 分割线一

- 语法

```
第一段
***
第二段
```

- 效果

第一段
***
第二段

##### 分割线二

- 语法

```
第一段

---

第二段
```

- 效果

第一段

---

第二段

##### 换行

- 语法

```
第一段<br>第二段
```

- 效果

第一段<br>第二段

# 文字样式

##### 上标【typora】

此为typora独有，并非markdown语法。

- 语法

```
X^2^
```

- 效果

X^2^

**下标**【typora】

此为typora独有，并非markdown语法。

- 语法

```
H~2~O
```

- 效果

H~2~O

##### 斜体

- 语法

```
*kakazai.cn*
```

- 效果

*kakazai.cn*

##### 加粗

- 语法

```
**kakazai.cn**
```

- 效果

**kakazai.cn**

##### 高亮

- 语法

```
==kakazai.cn==
```

- 效果

==kakazai.cn==

##### 划线

- 语法

```
~~kakazai.cn~~
```

- 效果

~~kakazai.cn~~

##### 下划线【typora】

- 语法

```
<u>kakazai.cn</u>
```

- 效果

<u>kakazai.cn</u>

##### 字体大小

- 语法

```
<font size=5>kakazai.cn</font>
```

- 效果

<font size=5>kakazai.cn</font>

##### 字体颜色

- 语法

```
<font color=blue>kakazai.cn</font>
```

- 效果

<font color=blue>kakazai.cn</font>

##### 字体

- 语法

```
<font face="宋体">kakazai.cn</font>
```

- 效果

<font face="宋体">kakazai.cn</font>

##### 文字居中【typora】

- 语法

```
<center>kakazai.cn</center>
```

- 效果

<center>kakazai.cn</center>

#代码

#####行内代码

- 语法

```
`代码`
```

- 效果

`代码`

- 场景

1.行内代码：使用`import  包名`可以一次性导入包中所有的模块

2.强调名词：每个子图`Axes`拥有自己的坐标系统。`Axis`是坐标轴。

- 快捷键

代码块在typora中没有常用的快捷键，可以修改配置文件

##### 代码高亮

- 语法

```
```python
  import numpy as np
  a = 1
  print(a)
```

- 效果
```python
import numpy as np
a = 1
print(a)
```

- 小技巧
  - 代码全选：光标位于代码内，ctrl + c 可以全选代码【typora】
  - shift+tab可以往右移动代码，tab可以往左边移动代码【typora】

# 列表

##### 无序列表

- 技巧

1. 用Tab键可以降到下一级，enter可以升到上一级【typora】

2. 出问题在源代码模式下解决

- 语法

```
# - + * 号都有同样功能
- 列表1
  - 列表1.1
  - 列表1.2
    - 列表1.2.1
      - 列表1.2.1.1
```

- 效果

- 列表1
  - 列表1.1
  - 列表1.2
    - 列表1.2.1
      - 列表1.2.1.1

##### 有序列表

1. 
2.  
3.

##### 代办事项

- 语法

```
- [ ] 未完成事项
- [x] 已完成事项
```

- 效果
- [ ] 未完成事项
- [x] 已完成事项

# 表格

##### 表格

- 语法

```
大标题1|大标题2|大标题3
---|---|---
内容1|内容2|内容3
内容1|内容2|内容3
```

- 效果

| 大标题1 | 大标题2 | 大标题3 |
| ------- | ------- | ------- |
| 内容1   | 内容2   | 内容3   |
| 内容1   | 内容2   | 内容3   |

技巧：ctrl+e 选中表格内的单元格内容

##### 对齐

- 语法

```
左对齐|居中对齐|大标题3
:---|:---:|---:
内容1|内容2|内容3
内容1|内容2|内容3
```

- 效果

| 左对齐 | 居中对齐 | 大标题3 |
| :----- | :------: | ------: |
| 内容1  |  内容2   |   内容3 |
| 内容1  |  内容2   |   内容3 |

# 链接

##### 文字链接

- 语法

```
[kakazai.cn](http://www.kakazai.cn)
```

- 效果

[kakazai.cn](http://www.kakazai.cn)

# 图片

##### 插入本地图片

直接把图片拖到窗口中

##### 用链接插入图片

- 语法

```
![大头贴](http://img3.redocn.com/tupian/20160112/yezibiankuangsheji_5746505_small.jpg)
```

- 效果

![大头贴](http://img3.redocn.com/tupian/20160112/yezibiankuangsheji_5746505_small.jpg)

##### 用注释插入图片

- 语法

```
![大头贴][1]
[1]:http://img3.redocn.com/tupian/20160112/yezibiankuangsheji_5746505_small.jpg
```

- 效果

![大头贴][1]

[1]:http://img3.redocn.com/tupian/20160112/yezibiankuangsheji_5746505_small.jpg

##### 图片居中并调整大小

- 语法

```
<div align="center"><img src="http://img3.redocn.com/tupian/20160112/yezibiankuangsheji_5746505_small.jpg" width="20%" height=""
></div>
```

- 效果

# 引用

##### 引用

- 语法

```
>kakazai.cn
```

- 效果

> kakazai.cn

##### 再引用

- 语法

```
>kakazai.cn
>>kakazai.cn
>>>kakazai.cn
```

- 效果

>kakazai.cn
>>kakazai.cn
>>
>>>kakazai.cn

##### 文献引用

- 语法

```
博客主页[^1]
[^1]:kakazai.cn
```

- 效果

博客主页[^1]

[^1]:kakazai.cn

- 场景
  - 引用地址：网址

想在表格中放记录的网址，但是网址一般很长，这样会导致表格太大，不好看，可以用引用的方式记录网址，让表格更美观，又不丢失网址信息。

| 内容                 | 开始-结束=总时长 | 日期      | 网址 |
| -------------------- | ---------------- | --------- | ---- |
| 决策树和随机森林[^1] | 10:01 -          | 2019-2-19 |      |

[^1]:https://www.bilibili.com/video/av26086646?from=search&seid=14580252154125454391

- 注意事项
  - 此为typora独有，并非markdown语法。
  - 每个标号只能用一次，若重复使用，只保留第一次的引用

# 公式

##### 行内公式

- 语法

```
这是一条直线$y=x+1$，这是一个双曲线$y=x^{2}+1$
```

- 效果

这是一条直线$y=x+1$，这是一个双曲线$y=x^{2}+1$

##### 行间公式

**【typora】创建行间公式**

1. 点击“段落”—>”公式块”

2. 快捷键Ctrl+Shift+m

3. “$$”+回车

- 语法

```
这是一条直线
$$y=x+1$$
```

- 效果

这是一条直线
$$y=x+1$$

# 注释

##### 文档注释

在导出到PDF时候，不会显示。

- 语法

```

```

- 效果

# API

##### 腾讯视频API
```
<iframe frameborder="0" width="600" height ="300" src="https://v.qq.com/txp/iframe/player.html?vid=j0831vwjj12" allowFullScreen="true"></iframe>
```

B站视频API
```
<iframe src="https://www.bilibili.com/video/av35579542/" frameborder="no" width="600" height ="300" allowfullscreen="true"> </iframe>
```

# typora

#### 为什么选择typora？

- 虽然它不开源，但目前该应用在测试期间，测试版完全免费
- 界面简洁，美观，支持多种主题
- 所见即所得的Markdown编辑
- **侧边栏有文件视图和大纲视图，方便编辑**
  - 利用侧边栏，迅速实现文件之间的转换
  - 利用大纲，实现文件内容的快速定位
- 支持传统的markdown语法，并进行部分扩展
  - Typora借用HTML代码，扩展功能：下划线、居中
  - 其他扩展功能：上标，下标
- 能将markdown文章转换为HTML，PDF，word文档等
  - 在网站上的部署HTML网页
- 右键菜单
- 快捷键系统
- 偏好设置
- 小功能
  - 表格挪动

#### typora的网址

官网：https://www.typora.io/

主题网址：https://theme.typora.io

#### typora 快捷键

##### 常用快捷键列表

| 类别     | 功能               | 快捷键                                 |
| -------- | ------------------ | -------------------------------------- |
| 表格     | 表格               | ctrl+t                                 |
| 列表     | 无序列表           | 输入-之后输入空格                      |
|          | 有序列表           | 输入数字+“.”之后输入空格               |
|          | 任务列表           | -[空格]空格 文字                       |
| 题目     | 标题               | ctrl+数字                              |
|          | 生成目录           | [TOC]按回车                            |
| 文字样式 | 加粗               | ctrl+b                                 |
|          | 倾斜               | ctrl+i                                 |
|          | 下划线             | ctrl+u                                 |
|          | 删除线             | alt+shift+5                            |
| 代码     | 代码块             | ctrl+alt+f                             |
| 链接     | 插入图片           | 直接拖动到指定位置即可<br>ctrl+shift+i |
|          | 插入链接           | ctrl+k                                 |
|          | 引用               | 输入>之后输入空格                      |
| 选中     | 选中一整行         | ctrl+l                                 |
|          | 选中单词           | ctrl+d                                 |
|          | 选中相同格式的文字 | ctrl+e                                 |
| 位置     | 跳转到文章开头     | ctrl+home                              |
|          | 跳转到文章结尾     | ctrl+end                               |
| 查找替换 | 搜索               | ctrl+f                                 |
|          | 替换               | ctrl+h                                 |

##### 设置快捷键

Tpyore中大部分的操作都是有快捷键的。但是有那么几个常用的却没有快捷键。就比如代码块。

可以通过修改配置文件来设置快捷键。

步骤：文件->偏好设置->打开高级配置->打开...\Typora\conf文件夹->打开conf.user.json文件->设置内容如下：

```
 // Custom key binding, which will override the default ones.
  "keyBinding": {
    // for example: 
    // "Always on Top": "Ctrl+Shift+P"
  "Code Fences":"Ctrl+Shift+a", //设置代码块的快捷键
  "Ordered List":"Ctrl+Shift+s",  //设置有序列表的快捷键
  "Unordered List":"Ctrl+Shift+d"  //设置无序列表的快捷键
  "Task List":"Ctrl+Shift+f"  //设置任务列表的快捷键
  },
```

# 参考

https://sspai.com/post/45816	Markdown快速入门

https://baka943.coding.me/2018/02/08/2018-02-08-TyporaSimpleDoc/	Typora 编辑器 ———— 书写即为美学