markdown是一种轻量级的标记语言,常常被用来写博客,在R语言中,通过rmarkdown写分析报告也是非常方便的,markdown可以被转为html,pdf,word格式文档。本文介绍markdown的一些基本语法。
标题
用n个# title
号表示,其中1<=n<=6,title为标题内容,注意空格。标题前必须空一行!
例子:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
效果:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
链接
用[title](URL)
表示,其中title为链接标题,URL为链接。
例子:
[R语言--不均衡问题处理](https://mp.weixin.qq.com/s/fitU6XxgwlONQ1aqLItPdg)
效果: R语言–不均衡问题处理
图片
用![title](URL)
表示,其中title为图片的替代文字,URL为图片的地址。地址可以网络地址或本地地址。
例子:
![markdown](https://www.mdeditor.com/images/logos/markdown.png "markdown")
效果:
字体效果
斜体
用*italics*
或者_italics_
表示,其中italics为斜体的内容,前后各一个*
或者_
符号。
例子:
*斜体字* _斜体字_
效果: 斜体字 斜体字
加粗
用**bold**
或者__bold__
表示,其中bold为加粗的内容,前后各两个*
或_
符号。
例子:
**粗体字** __粗体字__
效果: 粗体字 粗体字
粗斜体
用***text***
或者___text___
表示,其中text为粗斜体内容,前后各三个*
或_
符号。
例子:
***粗斜体字*** ___粗斜体字___
效果: 粗斜体字 粗斜体字
删除线
用~~text~~
表示,其中text为删除的文本,前后各两个~
符号。
例子:
~~删除~~
效果: 删除
段落效果
换行
用行末加上n个空格
表示,其中n>=2。
例子:
第一行(行末2个空格)
第二行
效果:
第一行(行末2个空格)
第二行
首行缩进
用全角的n个空格
实现,其中n一般为2,表示首行缩进两个字符。
例子:
关注公众号,
获得更多信息!
效果:
关注公众号,
获得更多信息!
分割线
用4个-
表示。分割线前必须空一行!
例子:
----
效果:
引用/区块
用>text
表示,其中text表示引用(区块)的内容。引用前必须空一行!
效果:
引用的内容
列表
列表分为无序列表和有序列表。列表前必须空一行!
无序列表
无序列表用*(或+、-) text
表示,其中text为列表内容,注意空格。
效果:
- 第一项
- 第二项
- 第三项
有序列表
有序列表用n. text
表示,其中n>=0,text为列表内容,注意空格。
效果:
- 第零项
- 第一项
- 第二项
- 第三项
嵌套列表
嵌套列表指无序列表和有序列表混合在一起使用。嵌套时需要相对父项在子项的前面加上2个Tab
。
例子:
* 第一级1
1. 第二级1
* 第三级1
* 第三级2
2. 第二级2
1. 第三级1
2. 第三级2
* 第一级2
* 第二级1
* 第三级1
* 第三级2
* 第二级2
* 第三级1
* 第三级2
效果:
表格
单元格的分隔符用|
表示。表头的分隔符用-
表示。表格前必须空一行!
-
:-
或-
(默认)表示表头和单元格左对齐 -
-:
表示表头和单元格右对齐 -
:-:
表示表头和单元格居中对齐
例子:
左对齐表头|右对齐表头|居中对齐表头
:-|-:|:-:
左对齐单元格|右对齐单元格|居中对齐单元格
左对齐单元格|右对齐单元格|居中对齐单元格
效果:
左对齐表头 | 右对齐表头 | 居中对齐表头 |
左对齐单元格 | 右对齐单元格 | 居中对齐单元格 |
左对齐单元格 | 右对齐单元格 | 居中对齐单元格 |
代码
markdown插入代码分为行内代码和多行代码。多行代码嵌套多行代码或行内代码用Tab
实现,行内代码嵌套行内代码或多行代码用空格
实现。
行内代码
行内代码用``
包裹代码,也可以包裹文本、符号等其他内容。
例子:
`code`
效果:code
多行代码
多行代码用两个` ````包裹一段代码,并可指定一种编程语言进行高亮。
例子:
```r
library(lubridate)
now()
```
效果:
library(lubridate)
now()
HTML标签
markdown是轻量级的标记语言,支持少数的HTML标签。有的markdown功能用HTML标签也能实现,如也可以用<br>
标签实现换行。
支持的HTML标签有:<kbd>
、<b>
、<i>
、<em>
、<sup>
、<sub>
、<br>
等。
例子:
第一行<br>第二行
效果:
第一行
第二行
转义
Markdown 使用了很多特殊符号来表示特定的意义,如果需要显示原本的符号则需要使用转义字符,Markdown 使用反斜杠\
转义特殊字符。
例子:
**加粗**
\*\*不会加粗\*\*
效果:
加粗
**不会加粗**
其他支持的符号有:
符号 | 解释 |
` | 反引号 |
* | 星号 |
_ | 下划线 |
{} | 花括号 |
[] | 方括号 |
() | 小括号 |
# | 井字号 |
+ | 加号 |
- | 减号 |
. | 英文句点 |
! | 感叹号 |
公式
使用美元符$
包裹TeX或LaTeX格式的数学公式来实现。
行内公式
在文字中插入公式,用1个$
符号包裹公式。
例子:
勾股定理:$c^2=a^2+b^2$,其中c为斜边。
效果:
勾股定理:,其中c为斜边。
行间公式
插入独占一行的公式,用2个$
符号包裹公式。
例子:
勾股定理:
$$c^2=a^2+b^2$$
其中c为斜边。
效果:
勾股定理:
其中c为斜边。
当公式较长时,也可以分行写。
例子:
$$
\displaystyle
\left( \sum\_{k=1}^n a\_k b\_k \right)^2
\leq
\left( \sum\_{k=1}^n a\_k^2 \right)
\left( \sum\_{k=1}^n b\_k^2 \right)
$$
效果:
Latex数学公式
Latax写数学公式,有较多语法。如^
符号表示上标,_
表示下标等。下面列举Latex数学公式中的一些符号的表示方法,其他的可自行百度。
Latex | 含义 |
^ | 上标 |
_ | 下标 |
\times | 乘 |
\div | 除 |
\sum | 累积和 |
\sqrt | 根号 |
\alpha | 希腊字母α |