一 .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")