Markdown 语法说明
Markdown是一种标记语言,主要用于网页上文本格式设置。它的使得我们可以使用普通的文本编辑器编辑网页文本。在页面显示用Markdown语法的文本,需要先转换为HTML格式再进行显示。Markdown使得普通文本和网页文本通过一种简单的格式关联了起来,文本编辑者不在需要了解复杂的HTML标签。同时,你也可以在Markdown格式的文本中使用HTML标签,这样可以补全一些Markdown语法不具备的功能,比如文字的显示颜色。
本文中不会对Markdown语法转换原理和转换后的HTML标签进行说明,只会列举Markdown的格式显示效果。
我为什么要用Markdown
因为我搭建的博客支持使用Markdown来构建博文,并且Markdown作为一种标记语言学习简单,而且作为程序员,使用标记语言来写作会更加符合那种高逼格与众不同的形象~
标题
Markdown中的标题使用#
进行标识, Markdown支持六级标题,标题1可以作为文本题目的显示,标题2后会跟一个下划线(HEXO搭建的博客支持Markdown语法写的文本,并且会根据标题格式生成博文目录,不过只会支持从标题2开始的标题)。
标题1
标题2
标题3
标题4
标题5
标题6
以上文本的显示效果为
文字格式
斜体。
*斜体*
显示为 斜体粗体。
**粗体**
显示为 粗体
文本块
引用文本块
强调引用的文本格式是一个文本块,使用>开头的文本会被显示为文本块
这是一个
引用的文本
会被显示为
这是一个
引用的文本
代码块
代码块有三种
- 一种是插入到文本中的
这是一小节代码
,使用的格式为
这是一小节代码
- 一种是一整段的代码,这个整段代码的格式和特殊字符都会保留而不会被转换。每一行的文本前面增加缩进可以实现代码块的显示,可以缩进一个,也可以缩进两个。
<Tab缩进>public CmdLineDiskMetrics(AbstractUnixCollector execWrapper, LogService logService,
<Tab缩进> UnixAgentPropertyWrapper properties) {
<Tab缩进>mExecWrapper = execWrapper;
<Tab缩进>mLogger = logService.getLogger(CmdLineDiskMetrics.class);
<Tab缩进>mStringUtils = new StringUtils(logService, CmdLineDiskMetrics.class.getName());
<Tab缩进>mProperties = properties;
<Tab缩进>mIsDebugEnable = mLogger.getDebugLevel() >= 1;
<Tab缩进>
<Tab缩进>mHostResolver = new HostNameResolver(logService, execWrapper.getServices().getResolverService());
<Tab缩进>}
会被显示成
public CmdLineDiskMetrics(AbstractUnixCollector execWrapper, LogService logService,
UnixAgentPropertyWrapper properties) {
mExecWrapper = execWrapper;
mLogger = logService.getLogger(CmdLineDiskMetrics.class);
mStringUtils = new StringUtils(logService, CmdLineDiskMetrics.class.getName());
mProperties = properties;
mIsDebugEnable = mLogger.getDebugLevel() >= 1;
mHostResolver = new HostNameResolver(logService, execWrapper.getServices().getResolverService());
}
- 命令行格式的代码需要使用bash格式来显示,这样的格式会在每一条命令前面加上序号
````bash
$ commond1
$ commond2
````
会显示成
1 | $ commond1 |
表格
Markdown中使用形象的格式来表示表格(表格和上一个文本之间需要有一个空行分隔)
|标题1|标题2|
|—–|—–| #这一行是用来定义表格的对齐方式的
|第一格|第二格|
|第三格|第四格|
会显示一个如下的表格
标题1 | 标题2 |
---|---|
第一格 | 第二格 |
第三格 | 第四格 |
表格的对齐方式是通过表格标题下方的第二行|—-|—–|来定义的
----
表示左对齐-----:
表示右对齐:----:
表示居中对齐
超链接
定义一个超链接使用一下格式
Yuan
[]内的是要显示的文本,而()的前半部分是连接的地址,后半部分则是鼠标移动到链接上面要显示的内容。
最后的显示结果为 Yuan
图片
图片的格式和超链接是一样的,不同的地方是,在[]要留空,之后的()中只需要填入图片的网址即可
特殊字符
如果要正常显示特殊字符,需要在其前面使用\
标识,这样的话特殊字符就不会被转换。特殊字符包括:
!
`
<
[
]
(
)
*
+
-
_
.
如果是要同时显示括号的话只需要在后一个括号前面加上\
如:
() [] <>
会显示成
() [] <>