# 如何使用markdown

TIP

这一节对这源文件看效果更好, 另外这个组建是vuepress的,别当成markdown语法

# 为什么要使用markdown

官方语法指导网站 (opens new window)

markdown是一个优秀的快速记录语言,他实际上是自动解析一些符号到html标签, 所以由它编写而成的文档,是能够利用web的特性进行快速分发、转换各种格式等特点的

当然前期使用的时候会有点别扭,但只要坚持使用15天左右,你会爱上他的

编写markdown需要有markdown语法支持的编辑器,这里推荐以下几种:

  1. 如果你使用jetbrains系列的IDE可以右键-新建文件-xxx.md即可进入markdown编辑环节
    • 当然这种比较简陋阿,对于插入其他东西(图片等)就不太有好了
  2. 第二种我推荐Typora (opens new window)
    • 虽然是付费的,但是体验比较好,并且价格不高(89三台电脑)
  3. 第三个就是大神开源的marktext (opens new window)
    • 这个有些不完善,用起来有些bug
    • 但是初学者用用其实也没事,github的release里面有多种系统的打包格式可以下载安装

# markdown常用的语法

markdown的常用语法不多, 适当联系就可以掌握

写文档第一步基本上就是写一个标题,标题在markdown的表示为#号,最大支持5级标题

  • # 我是四级标题 #

  • # 我是五级标题 ##
  • 实际上就是大小不太一样

标题完成以后,基本上就是得写点内容

  • 在markdown里,除了特殊字符标记的内容,都会被解释为文本
  • 但是在非编辑器环境中,需要进行两次回车才能被识别为换行
  • 同时通常markdown没有首行空两个字符的语法(可以通过)
我是一段话

我是第二段话

中间没有空行的话,我会被识别为一整行哦

通常每段话又有需要强调的内容,这里就有了几个语法:

  1. 每行开头使用number.数字来表示需要按顺序阅读的内容
  2. 每行开头使用-空格 来表示非阅读顺序的内容
    • 就像这样子
  3. 如果表示层级关系的话,记得换一行按以下Tab就好了
    • 如果有多级别内容就可以这样子嵌套下去
  4. 有些时候文本中有些要强调的内容**内容**以及__内容__即可实现
    • 我就是例子
    • 我也是例子
    • 通常在解析器中**会被解析为黑体加粗
    • __会被标记为背景为黄色的区域
效果看上面渲染结果
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|本地绝对路径|本地相对路径都是可以的)
    • 但是注意,如果图片无法显示,更多的可能是格式不支持,通常使用jpgpng是能够识别的

通常文档还有一部分需要有人注意的内容,那么另起一行> 内容即可

我就是长这样子的


最后一部分就是关于代码插入以及忽略语法的符号了 代码插入的方法是另起一行输入```语言类型 另起一行填写内容```

print("hello world")

如果语言选对的话基本会有语法高亮显示,填错了就当纯文本解析了


有些时候我们需要填写的内容会被识别为特殊字符(和编程语言的转义符一样)

那么就得使用 `内容` 这样的形式来显示 

# 更为强大的markdown

markdown我感觉最强大的地方在于书写规范的数学公式

类似以下的形式,通常按照`$数学公式$`格式编写

$ \frac{\alpha}{\beta} $ 

如果支持的话就会显示为 α/β, 通过组合还能形成更为规范漂亮的数学公式
Last Updated: 2/16/2023, 9:15:44 PM