markdown基本语法
一、前言
要想成功!必先利其器
-
由于有些语法由于有些语法无法在博客园展示,推荐使用Typora解锁全套,下载地址:https://www.typora.io/
Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。 --摘自百度百科
之前项目一直使用word
撰写文档,有比较大的弊病:
- 只有对纯文本文件进行版本控制,而word是二进制格式
- 格式复杂,经常需要中断写作来控制格式
- 代码与文档分离,给编写文档造成很大的不便
而假如单纯的使用txt,就没有一点格式了,用html虽然既有格式又能加入版本控制,但是需要花费较多的时间在标签上,而且标签占了文档的较大百分比,不易阅读。
所以,最终的解决方案就是 Markdown ,作为一种轻量级的标记语言,能在非常短的时间内掌握。而且不仅可以用于写文档,还可以写博客、写简书、做一些随手笔记。Markdown文件以.md结尾,可以导出为html和PDF(需要使用的工具支持)。它是一种语法(个人认为是简化版的html),但是和html不同的是,各种解析器对其会有不同的表现。比如我的IDEA Markdown插件会把分割线显示成一条细灰线,Cmd Markdown则是显示一条虚线。所以建议保持使用一种Markdown工具和尽量使用标准语法。
二、Markdown基本语法
2.1 标题
代码:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 最小只有六级标题
效果:
一级标题
二级标题
三级标题
四级标题
五级标题
最小只有六级标题
2.2 加粗
代码:
**一起加粗***
效果:
一起加粗
2.3 斜体
代码:
*倾斜了*
效果:
倾斜了
2.4 高亮
代码:
==高亮==
效果:
高亮
2.5 上标
代码:
2^2^
效果:
22
2.6 下标
代码:
H~2~o
效果:
H2O
2.7 代码引用(>)
代码:
>hello markdown!
效果:
hello markdown!
代码:
>hello markdown!
>> hello markdown!
hello markdown!
hello markdown!
2.8 代码引用(```式)
代码:
```python
print("hello world")
效果:
print("hello world")
2.9 代码引入(`式)
代码:
'print(hello world)'
效果:
print('hello world')
2.10 插入链接(链接显示)
代码:
<https://www.cnblogs.com/randysun/>
效果:
https://www.cnblogs.com/randysun/
2.11 插入链接(链接描述显示)
代码:
[RandySun博客](https://www.cnblogs.com/randysun/ "RandySun博客")
效果:
2.12 插入图片(链接)
代码:
![数据类型总结-搞笑结束.jpg](http://www.chenyoude.com/Python从入门到放弃/数据类型总结-搞笑结束.jpg'描述信息')
效果:
2.13 插入图片(图片路径)
-
绝对路径:.md文本同目录下图片的名字
-
相对路径:图片在电脑中的路径地址
代码
![绝对路径](数据类型总结-搞笑结束.jpg '好牛逼')
![相对路径](C:UsersRandySunDesktop数据类型总结-搞笑结束.jpg "快鼓掌")
效果:
绝对路径:
相对路径:
2.14 有序列表
代码:
1.one
2.two
3.three
效果:
- one
- two
- three
2.15 无序列表
代码:
* one
* tow
* three
效果:
- one
- tow
- three
2.16分隔线
代码:
---
效果:
2.17表格而且第二行必须有,并且第二行的冒号代表对齐格式,分别为居中;右对齐;左对齐
代码:
name | age | sex
:-:|:-|-:
randy|18|男
randysun|19|男
效果:
name | age | sex |
---|---|---|
randy | 18 | 男 |
randysun | 19 | 男 |
2.18数学公式(行内嵌)
代码:
内嵌数学公式$sum_{i=1}^{10}f(i)\,\, ext{thanks}$
效果:
内嵌数学公式(sum_{i=1}^{10}\,\, ext{thanks})
2.19数学公式(块状)
代码:
$$
sum_{i=1}^{10}f(i)\,\, ext{thanks}
$$
效果:
三、总结
以上所述就是Markdown的基本标签,虽然不多,但是可以解决大部分情况,可以用20%的标签完成80%的效果
注:基础markdown语法参考:https://www.appinn.com/markdown/
插入数学公式markdown语法参考:https://www.zybuluo.com/codeep/note/163962