[TOC]

Markdown 入门

Markdown是一种轻量级标记语言,其文件拓展名为.md.markdown,可将.md文件导出为多种格式,如 PDF、HTML、DOCX、EPUB 等。实际Markdown文档就是网页,完全可以用HTML代码编写文档。编辑器推荐使用TyporaVSCode

Markdown标准请参考CommonMark

注意:VSCode要安装插件Markdown All in OneMarkdown Preview Enhanced才支持扩展语法和增强文档预览。

Typora 官方站
Typora 官方中文站

以下是我使用Typora的偏好配置:

  • 允许折叠和展开侧边栏的大纲视图
  • 开启自动保存
  • 不记录历史文件和文件夹
  • 默认缩进为4
  • 默认换行符为CRLF
  • 不使用拼写检查
  • 开启严格模式
  • 开启所有Markdown扩展语法
  • 代码块显示行号,自动换行,代码缩进为4
  • 使用Github主题,可自定义主题css
  • 关闭自动检查更新
  • 开启调试模式,文档右键检查元素可进入开发者工具
  • 不发送匿名使用数据
  • 开启Typora使用国内服务器
  • 菜单栏有很多实用技巧,用快捷键快速编辑文档
  • 使用[TOC]可以自动生成目录
  • Typora+PicGo+OSS+CDN可以自建图床,储存文档图片并加速访问

标题

1
2
3
4
5
6
7
8
9
10
11
# 一级标题 h1

## 二级标题 h2

### 三级标题 h3

#### 四级标题 h4

##### 五级标题 h5

###### 六级标题 h6

文本样式

1
2
3
4
5
6
7
8
9
10
11
12
13
**加粗**

__加粗__

*斜体*

_斜体_

***斜体加粗***

___斜体加粗___

~~删除线~~

以下为扩展语法,部分解析器支持

1
2
3
4
5
==高亮==

我是^上标^

我是~下标~

列表

无序列表

1
2
3
4
5
6
7
8
9
10
11
- 无序列表项1
- 无序列表项2
- 无序列表项3

* 无序列表项4
* 无序列表项5
* 无序列表项6

+ 无序列表项7
+ 无序列表项8
+ 无序列表项9

有序列表

1
2
3
1. 有序列表项1
2. 有序列表项2
3. 有序列表项3

嵌套列表

1
2
3
4
1. 一级列表项1
- 二级列表项1
- 二级列表项2
2. 一级列表项2

任务列表

1
2
- [x] 任务列表1
- [ ] 任务列表2

引用

可基本引用也可嵌套引用

1
2
3
4
>一二三四五
>>上山打老虎
>>>老虎没打到
>>>>打到小松鼠

代码

1
2
3
行内代码如下:

`我是代码`
1
2
3
代码块如下:

```我是代码块```

表格

1
2
3
4
| 左对齐 | 居中对齐 | 右对齐 |
| :--- | :---: | ---: |
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |

分割线

1
2
3
***
---
___

脚注

1
2
文本[^脚注名]
[^脚注名]:脚注文本

链接

行内式链接

1
[链接文本](链接地址)

参考式链接

其实和脚注语法类似
先在文本中使用

1
[链接文本][链接标记]

然后在文档其他位置定义

1
[链接标记]: 链接地址
1
2
3
4
5
比如:
先在文本中写
[必应][bing]
在文档其他位置写
[bing]: https://cn.bing.com

图片

1
2
3
![图片替代文本](图片地址)
比如:
![示例图片](https://example.com/image.jpg)

Emoji表情

直接从Emojipedia复制(硬编码方式)
🎉🎉🎉

$\LaTeX$

LaTeX标准请参考LaTeX - A document preparation system