markdown基本语法

Posted 2021-03-23 springsnow

一、前言#

• 由于有些语法无法在博客园展示，推荐使用Typora解锁全套，下载地址：https://www.typora.io/
• 推荐使用jupyter，使用方法：https://www.cnblogs.com/nickchen121/p/10722733.html
• markdown数学公式大全，https://www.cnblogs.com/nickchen121/p/11746655.html

Copy
Markdown是一种可以使用普通文本编辑器编写的标记语言，通过简单的标记语法，它可以使普通文本内容具有一定的格式。    --摘自百度百科

没想到一向不太靠谱的百度百科这次竟有了如此精辟的解释。之前项目一直使用word撰写文档，有比较大的弊病：

• 只能对纯文本文件进行版本控制，而word是二进制格式
• 格式繁杂，经常需要中断写作来控制格式
• 代码与文档分离，给写文档造成更大的阻力

而假如单纯的使用txt，就没有一点格式了，用html虽然既有格式又能加入版本控制，但是需要花费较多的时间在标签上，而且标签占了文档的较大百分比，不易阅读。

Copy
所以，最终的解决方案就是 **Markdown** ，作为一种轻量级的标记语言，能在非常短的时间内掌握。而且不仅可以用于写文档，还可以写博客、写简书、做一些随手笔记。Markdown文件以.md结尾，可以导出为html和PDF（需要使用的工具支持）。它是一种语法（个人认为是简化版的html），但是和html不同的是，各种解析器对其会有不同的表现。比如我的IDEA Markdown插件会把分割线显示成一条细灰线，Cmd Markdown则是显示一条虚线。所以建议保持使用一种Markdown工具和尽量使用标准语法。

二、Markdown基本语法#

2.1 标题#

代码：

Copy
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 最小只有六级标题

效果：

过于粗暴，不予以展示，你复制粘贴即知晓！！！

2.2 加粗#

代码：

Copy
**我被加粗了**

效果：

我被加粗了

2.3 斜体#

代码：

Copy
*我倾斜了了*

效果：

我倾斜了了

2.4 高亮#

代码：

Copy
==我高亮了==

效果：

==我高亮了==

2.5 上标#

代码：

Copy
2^2^

效果：

2^2^

2.6 下标#

代码：

Copy
H~2~o

效果：

H~2~o

2.7 代码引用（>式）#

代码：

Copy
> hello markdown!

效果：

hello markdown!

代码：

Copy
> hello markdown!
>> hello markdown!

效果：

hello markdown!

hello markdown!

2.8 代码引用（```式）#

代码：

Copy
# 不要复制这一句话，并且去掉下面的反斜杠，谢谢！
```python
print(‘hello nick‘)
```

效果：

Copy
print(‘hello nick‘)

2.9 代码引入（`式）#

代码：

Copy
# 不要复制这一句话，并且去掉下面的反斜杠，谢谢！
`print(‘hello nick‘)`

效果：

print(‘hello nick‘)

2.10 插入链接（链接显示）#

代码：

Copy
<https://www.cnblogs.com/nickchen121/p/10718112.html>

效果：

https://www.cnblogs.com/nickchen121/p/10718112.html

2.11 插入链接（链接描述显示）#

代码：

Copy
[nickchen博客](https://www.cnblogs.com/nickchen121/p/10718112.html "nickchen博客")

效果：

nickchen博客

2.12 插入图片（链接）#

代码：

Copy
![数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark](https://image.cha138.com/20210620/11246aaff6b242feb812fcc0cecf5337.jpg ‘描述信息‘)

效果：

2.13 插入图片（图片路径）#

• 绝对路径：.md文本同目录下图片的名字，如数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark
• 相对路径：图片在电脑中的路径地址，如Users ickmacdesktop数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark

代码：

Copy
![数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark](数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark ‘描述信息‘)

![数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark](Users
ickmacdesktop数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark ‘描述信息‘)

效果：

2.14 有序列表#

代码：

Copy
1. one
2. two 
3. three

效果：

1. one
2. two
3. three

2.15 无序列表#

代码：

Copy
* one
* two
* three

效果：

• one
• two
• three

2.16 分割线#

代码：

Copy
---

效果：

---

2.17 表格而且第二行必须得有，并且第二行的冒号代表对齐格式，分别为居中；右对齐；左对齐）：#

Copy
name | age | sex 
:-:|:-|-:
tony|20|男
lucy|18|女

效果：

name
age
sex

nick
19
男

jason
18
女

2.18 数学公式（行内嵌）#

代码：

Copy
内嵌数学公式$sum_{i=1}^{10}f(i),,	ext{thanks}$

效果：

内嵌数学公式∑ 10 i=1 f(i)thanks <?XML:NAMESPACE PREFIX = "[default] http://www.w3.org/1998/Math/MathML" NS = "http://www.w3.org/1998/Math/MathML" />∑i=110f(i)thanks

2.19 数学公式（块状）#

代码：

Copy
$$
sum_{i=1}^{10}f(i),,	ext{thanks}
$$

效果：

∑ i=1 10 f(i)thanks ∑i=110f(i)thanks

三、总结#

以上所述就是Markdown的基本标签，虽然不多，但是可以解决大部分情况。

可以用20%的标签完成80%的效果

基础markdown语法参考：https://www.appinn.com/markdown/

插入数学公式markdown语法参考：https://www.zybuluo.com/codeep/note/163962