# 如何使用markdown
TIP
这一节对这源文件看效果更好, 另外这个组建是vuepress的,别当成markdown语法
# 为什么要使用markdown
markdown是一个优秀的快速记录语言,他实际上是自动解析一些符号到html标签, 所以由它编写而成的文档,是能够利用web的特性进行快速分发、转换各种格式等特点的
当然前期使用的时候会有点别扭,但只要坚持使用15天左右,你会爱上他的
编写markdown需要有markdown语法支持的编辑器
,这里推荐以下几种:
- 如果你使用jetbrains系列的IDE可以
右键-新建文件-xxx.md
即可进入markdown编辑环节- 当然这种比较简陋阿,对于插入其他东西(图片等)就不太有好了
- 第二种我推荐Typora (opens new window)
- 虽然是付费的,但是体验比较好,并且价格不高(89三台电脑)
- 第三个就是大神开源的marktext (opens new window)
- 这个有些不完善,用起来有些bug
- 但是初学者用用其实也没事,github的release里面有多种系统的打包格式可以下载安装
# markdown常用的语法
markdown的常用语法不多, 适当联系就可以掌握
写文档第一步基本上就是写一个标题,标题在markdown的表示为#
号,最大支持5级标题
标题完成以后,基本上就是得写点内容
- 在markdown里,除了特殊字符标记的内容,都会被解释为文本
- 但是在非编辑器环境中,需要进行两次回车才能被识别为换行
- 同时通常markdown没有首行空两个字符的语法(可以通过)
我是一段话
我是第二段话
中间没有空行的话,我会被识别为一整行哦
通常每段话又有需要强调的内容,这里就有了几个语法:
- 每行开头使用
number.
数字来表示需要按顺序阅读的内容 - 每行开头使用
-空格
来表示非阅读顺序的内容- 就像这样子
- 如果表示层级关系的话,记得换一行按以下
Tab
就好了- 如果有多级别内容就可以这样子嵌套下去
- 有些时候文本中有些要强调的内容
**内容**
以及__内容__
即可实现- 我就是例子
- 我也是例子
- 通常在解析器中
**
会被解析为黑体加粗 - 而
__
会被标记为背景为黄色的区域
效果看上面渲染结果
1. 每行开头使用`number.`数字来表示需要按顺序阅读的内容
2. 每行开头使用`-空格` 来表示非阅读顺序的内容
- 就像这样子
- hh
- hh1
- hh2
- hhh1
# markdown的高级语法
学习完上面几个写法,就能使用markdown完成基础的笔记了
接下来介绍几个其他的markdown语法
通常一个文件有插入图片还有表格的需要在,那么就可以使用下面的语法:
列1 | 列2 | 列3 |
---|---|---|
内11111 | 内222222 | 内3333333 |
| 列1 | 列2 | 列3 |
| :--:|:--:|:--|
| 内1 | 内2 | 内3 |
其中 :--: 代表居中,:--就是居左,--:就是居右
图片的插入实际上是链接的插入,语法如下
- 我是本项目的链接 (opens new window)
[我是本项目的链接](https://github.com/aprogrotess/ky-AICommunity)
- 图片的语法就是加上
!
![图片描述](图片链接 web|本地绝对路径|本地相对路径都是可以的)
- 但是注意,如果图片无法显示,更多的可能是格式不支持,通常使用
jpg
,png
是能够识别的
通常文档还有一部分需要有人注意的内容,那么另起一行> 内容即可
我就是长这样子的
最后一部分就是关于代码插入以及忽略语法的符号了
代码插入的方法是另起一行输入```语言类型 另起一行填写内容```
print("hello world")
如果语言选对的话基本会有语法高亮显示,填错了就当纯文本解析了
有些时候我们需要填写的内容会被识别为特殊字符(和编程语言的转义符一样)
那么就得使用 `内容` 这样的形式来显示
# 更为强大的markdown
markdown我感觉最强大的地方在于书写规范的数学公式
- 但这得看编辑器的支持程度了(需要Letex支持),这也是我为什么推荐typora的原因
- 这里贴出markdown基本数学符号 (opens new window)
类似以下的形式,通常按照`$数学公式$`格式编写
$ \frac{\alpha}{\beta} $
如果支持的话就会显示为 α/β, 通过组合还能形成更为规范漂亮的数学公式