前序
本文分为两部分,第一步为markdown的语法部分,第二部分为应用篇,在实际应用中总结markdown的使用技巧。markdown的语法部分比较简单,基本上稍加记忆都能够很好地使用。重点应放在日常使用markdown时的遇到的问题,以及相应的解决技巧或办法。
语法部分
标题
markdown中共有六级标题,格式为# 标题
(此处有空格)。符号#的个数对应标题的层级。
一级标题
二级标题
三级标题
字体样式
常用的字体样式有:粗体,斜体,粗斜体,删除线等。粗体用**文本内容**
表示,斜体用*文本内容*
表示,删除线用~~文本内容~~
表示。
我是粗体
我是斜体
我是粗斜体
这是一条删除线
引用
引用是用>文本内容
的格式来表示,代码引用通过```文本内容```
或者tab文本内容
或(四个空格)文本内容
表示。一条语句用一个`包起来,多段代码则用三个`包起来。
下面这段代码只是一个示例。
inp = input('Enter a Number:')
n = int(inp)
while n != 1:
print(n, end=' ') # Use comma to suppress newline
if n % 2 == 0: # n is even
n = n / 2
else: # n is odd
n = n * 3 + 1
表格
markdown对表格的支持并不友好,推荐使用HTML来绘制表格。
|表头|表头|表头|
|-:|:-:|:-|
|右对齐|居中|左对齐|
|hello|world|markdown|
表头 | 表头 | 表头 |
---|---|---|
右对齐 | 居中 | 左对齐 |
hello | world | markdown |
脚注
脚注是成对出现的。一般用[^1]
作为标记,[^1]:注释内容
作为注释。注释内容的位置随意,但始终显示在文末。点击脚注会跳至注释,点击注释会返回脚注标记。
文本编辑器[1]
markdown[2]
插入图片、链接
图片用格式!()[]
表示,而链接则用格式[]()
表示。注意,方括号和圆括号,以及感叹号均为半角。
最实用的十条Markdown语法
分割线
可以通过用连续的---
或者***
或者___
(三个下划线)来绘制一条分割线,效果如下:
注意:在分割线之前应空一行,否则容易出错。
列表
列表一般分为无序列表和有序列表。无序列表通过+
或*
或-
来表示,注意空格。
* 这是一项;
+ 这是第二项;
- 这是第三项;
- 这是一项;
- 这是第二项;
- 这是第三项;
而有序列表则使用1.
的形式。同样的,需要注意空格。
1. 这是一项;
2. 这是第二项;
3. 这是第三项;
- 这是一项;
- 这是第二项;
- 这是第三项;
缩进
在每一行的起始位置,输入以下代码,接着继续写文本即可。
全角空格: 或
半角空格: 或
不换行空格 或 ;
这样做很麻烦,这是因为markdown本身不负责首行缩进这个功能。可以采用的另一种方法如下,来自于知乎问题:在 Markdown 语言中,如何实现段首空格的显示
推荐全角空格,切换到全角模式下(一般的中文输入法都是按 shift + space)输入两个空格就行了。这个相对 来说稍微干净一点,而且宽度是整整两个汉字,很整齐。
本人在使用该方法的过程中发现,在某些markdown语法(如代码引用、标题等)后面,采用这种方式进行缩进会出现无法显示的问题。即使空一行也无法解决。暂时只能在这种情况下采用第一种方法。
上下标
上下标可以通过两种方式来实现。第一种方法将其视为数学公式,具体实现如下:
1. 公式的编辑都在符号$
之间;
2. 符号^
后接的字符为上标;
3. 符号_
后接的字符为下标;
4. 如果存在多个下标,要用符号{}
包起来。
$x^n_{ij}$
上面代码的显示效果为:。注意:上标和下标的顺序没有先后差别。
第二种方式则是采用HTML标签来实现。在HTML语言中,上标通过标签来实现,而下标则通过标签
来实现。
n2 = n + 1
a = log2b
商标符号:Apple®;
function符号:ƒ(x) = x2
根号:√5
角度符号:30°
n2 = n + 1
a = log2b
商标符号:Apple®
function符号:ƒ(x) = x2
根号:√5
角度符号:30°
更多HTML特殊符号可以参阅HTML中的特殊符号
数学公式
markdown中编辑数学公式基本是采用Latex格式。
-
用来编辑文本的软件。 ↩
-
一种轻量标记语言. ↩