一 .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^
效果:2^2^
1.6 下表: h~2 ~0
列:
h~2~0
效果:h~2~0
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 插入链接(链接显示)
列:代码
<;
效果:
2.1 插入链接(连接描述显示)[关键字 XXX博客]
列:代码
[WQ577098649博客]( "WQ577098649博客")
2.2插入图片(链接)
列:代码

效果:
2.3 插入图片()
- 绝对路径:.md文本同目录下图片的名字,如
数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark
- 相对路径:图片在电脑中的路径地址,如
\Users\nick\mac\desktop\数据类型总结-搞笑结束.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)\,\,\text{thanks}$
效果:内嵌数学公式$\sum_{i=1}^{10}f(i),,\text{thanks}$
2.9 数学公式(块状)
列:代码
$$
\sum_{i=1}^{10}f(i)\,\,\text{thanks}
$$
效果:
$$
\sum_{i=1}^{10}f(i),,\text{thanks}
$$