一 .Markdown 基本语法(前言介绍)
Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。 --摘自百度百科
没想到一向不太靠谱的百度百科这次竟有了如此精辟的解释。之前项目一直使用word
撰写文档,有比较大的弊病:
- 只能对纯文本文件进行版本控制,而word是二进制格式
- 格式繁杂,经常需要中断写作来控制格式
- 代码与文档分离,给写文档造成更大的阻力
而假如单纯的使用txt,就没有一点格式了,用html虽然既有格式又能加入版本控制,但是需要花费较多的时间在标签上,而且标签占了文档的较大百分比,不易阅读。
所以,最终的解决方案就是 **Markdown** ,作为一种轻量级的标记语言,能在非常短的时间内掌握。而且不仅可以用于写文档,还可以写博客、写简书、做一些随手笔记。Markdown文件以.md结尾,可以导出为html和PDF(需要使用的工具支持)。它是一种语法(个人认为是简化版的html),但是和html不同的是,各种解析器对其会有不同的表现。比如我的IDEA Markdown插件会把分割线显示成一条细灰线,Cmd Markdown则是显示一条虚线。所以建议保持使用一种Markdown工具和尽量使用标准语法。
1.1 标题
:符号的标题使用:
# :一级加粗
## :二级加粗
###: 三级加粗
####:四级加粗
#####:五极加粗
######:六级加粗
1.2 加粗 :** 内容 **
列:
**我爱你亲爱的姑娘**
效果:我爱你亲爱的姑娘
1.3 斜体 : * 内容 *
列:
*我倾斜了*
效果:我倾斜了
1.4 高亮 : ==内容 ==
列:
==我高亮了==
效果:我高亮了
1.5 上标 :2^2 ^
列:
2^2^
效果:22
1.6 下表: h~2 ~0
列:
h~2~0
效果:h20
2.7 代码块的引用(>式)
列:
> hello markdown!
效果: hello markdown!
代码:
> hello markdown!
>> hello markdown!
效果:
hello markdown!
hello markdown!
1.8 代码块的引用(```式)
列:
代码块的引用(
式)
print("hello liangjing")
效果:
print("hello liangjing")
### 1.9代码块入(`式)
列:
```代码块入(`式)
`print("hello liangjing")`
效果:print("hello liangjing")
2.0 插入链接(链接显示)<内容>
列:代码
<https://www.cnblogs.com/WQ577098649/p/11454375.html>
效果:https://www.cnblogs.com/WQ577098649/p/11454375.html
2.1 插入链接(连接描述显示)[关键字 XXX博客](...想要打开什么东西的链接....."WQ577098649博客")
列:代码
[WQ577098649博客](https://www.cnblogs.com/WQ577098649/p/11454375.html "WQ577098649博客")
2.2插入图片(链接)
列:代码
![数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark](http://www.chenyoude.com/Python从入门到放弃/数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark '描述信息')
效果:
2.3 插入图片()
- 绝对路径:.md文本同目录下图片的名字,如
数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark
- 相对路径:图片在电脑中的路径地址,如
Users ickmacdesktop数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark
代码:
![数据类型总结-搞笑结束.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.4 有序列表
列:代码
1.one
2.two
3.three
效果:1.one
2.two
3.three
2.5 无序列表
列:代码
*one
*two
*three
效果:onetwothree
2.6 分割线
列:代码
---
效果:
2.7 表格而且第二行必须得有,并且第二行的冒号代表队对齐格式,分别为剧中;右对齐;左对齐
name | age | sex
:-: | :- |-:
liangjing | 20 | 女
wangqing | 23 | 男
效果:
name | age | sex |
---|---|---|
liangjing | 20 | 女 |
wangqing | 23 | 男 |
2.8 数学公式(行内嵌)
列:代码
内嵌数学公式$sum_{i=1}^{10}f(i)\,\, ext{thanks}$
效果:内嵌数学公式$sum_{i=1}^{10}f(i),, ext{thanks}$
2.9 数学公式(块状)
列:代码
$$
sum_{i=1}^{10}f(i)\,\, ext{thanks}
$$
效果:
$$
sum_{i=1}^{10}f(i),, ext{thanks}
$$