Markdown基础教程
什么是Markdown?
Markdown是一种轻量级的标记语言,可用于将格式设置元素添加到纯文本文档中。由John Gruber(约翰·格鲁伯)于2004年创建。Markdown编写的文档可以导出HTML、Word、图像、PDF、Epub等多种格式的文档。文档后缀为.md,.markdown。
为什么要使用Markdown?
-
独立于平台。Markdown本身是纯文本,可以在运行任何操作系统的任何设备上创建Markdown格式的文本。
-
版本兼容性。不会因软件升级产生不同版本之间的兼容性问题。
-
便携式。几乎可以使用任何应用程序打开包含Markdown格式的文件。
编辑器
本教程将使用Typora编辑器来熟悉Markdown的语法,Typora支持MacOs、Windows、Linux等平台。
支持导出的格式:PDF、HTML、Word、Txt、图像等等。
ypora官网:https://typora.io
语法
标题
-
使用=和-标记一级和二级标题
语法:
一级标题 ====== 二级标题 -------效果:
一级标题
二级标题
-
使用#号标记1-6级标题(#号后加一个空格)
语法:
# 一级标题 ## 二级标题 ### 三级标题 #### 四级标题 ##### 五级标题 ###### 六级标题效果:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
字体
Markdown可以使用以下几种字体。
*斜体文字*
_斜体文字_
**粗体文字**
__粗体文字__
***粗斜体文字***
___粗斜体文字___
效果:
斜体文字
斜体文字
粗体文字
粗体文字
粗斜体文字
粗斜体文字
列表
-
无序列表(*、+、-后加一个空格)
语法:
* 你 * 好 * 呀 + 你 + 好 + 呀 - 你 - 好 - 呀效果:
-
你
-
好
-
呀
-
你
-
好
-
呀
- 你
- 好
- 呀
-
-
有序列表(使用数字加一个.号)
语法:
1.你 2.好 3.呀效果:
- 你
- 好
- 呀
-
列表嵌套
列表前他只需要在子列表前面加四个空格。
语法:
1. 你 - 你 - 好 2. 好 - 你 - 好效果:
- 你
- 你
- 好
- 好
- 你
- 好
- 你
区块
Markdown区块引用是在段落开头使用>符号,后面紧跟一个空格:
> 区块引用
> 你
> 好
效果:
区块引用
你
好
区块是可以嵌套的,一个>符号为最外层,两个>为第二层,以此类推:
> 最外层
>> 你
>>> 好
效果:
最外层
你
好
区块中使用列表
语法:
> 区块中使用列表
> 1. 你
> 2. 好
> * 你
> * 好
效果:
区块中使用列表
- 你
- 好
- 你
- 好
列表中使用区块
语法:
* 你
> 你
> 好
* 好
效果:
-
你
你
好 -
好
代码
-
如果是段落上的一个函数或片段的代码可以用 反引号(`)把它包起来。语法:
`print()`函数效果:
print()函数 -
代码区块
代码区块使用4个空格或者1个制表符(Tab键)。语法:
<!DOCTYPE html> <html lang="zh-cn" dir="ltr" >效果:
<!DOCTYPE html> <html lang="zh-cn" dir="ltr" >也可以使用3个反引号(```)包裹一段代码。
语法:
```javascript $(document).ready(function(){ alert('你好!'); }); ```效果:
$(document).ready(function(){ alert('你好!'); });
水平线
使用3个或更多的星号(*)或者下划线(_)。
语法:
你
*********
好
_________
效果:
你
好
链接
基本语法:
[连接名称](连接地址)
或者
<连接地址>
效果:
或者
高级链接
通过变量来设置一个链接,变量赋值在文档末尾进行:
这个链接使用 1 作为网址变量 [Google][1]
这个链接使用 你 作为网址变量[Baidu][你]
[1]:http://www.google.com/
[你]:https://www.baidu.com/
效果:
这个链接使用 1 作为网址变量 Google
这个链接使用 你 作为网址变量Baidu
图片
语法:




效果:


表格
语法:
使用|来分隔不同单元格,使用-来分割不同行。
|列1 |列2|
|--- |---|
|你 |好 |
对齐方式:
-:右对齐
:-左对齐
:-: 居中对齐
|左对齐|居中对齐|右对齐|
|:----|:-----:|----:|
|你 |好 |呀 |
效果:
| 列1 | 列2 |
|---|---|
| 你 | 好 |
| 左对齐 | 居中对齐 | 右对齐 |
|---|---|---|
| 你 | 好 | 呀 |
支持的HTML元素
不在Markdown涵盖范围之内的标签,都可以直接在文档里面用HTML标签撰写。
目前支持的HTML元素有:<kbd> <b> <i> <em> <sup> <sub> <br>等。语法:
使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑
你<br>好
a<sub>n</sub>
a<sup>x</sup>
效果:
使用 Ctrl+Alt+Del 重启电脑
你
好
an
ax
转义
Markdown 使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用转义字符,Markdown 使用反斜杠转义特殊字符:
\\ 反斜线
\` 反引号
\* 星号
\_ 下划线
\{} 花括号
\[] 方括号
\() 小括号
\# 井字号
\+ 加号
\- 减号
\. 英文句点
\! 感叹号
效果:
\ 反斜线
` 反引号
* 星号
_ 下划线
{} 花括号
[] 方括号
() 小括号
# 井字号
+ 加号
- 减号
. 英文句点
! 感叹号
公式
当你需要在编辑器中插入数学公式时,可以使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现。提交后,问答和文章页会根据需要加载 Mathjax 对数学公式进行渲染。如:
$$
\mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix}
\mathbf{i} & \mathbf{j} & \mathbf{k} \\
\frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \\
\frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \\
\end{vmatrix}
${$tep1}{\style{visibility:hidden}{(x+1)(x+1)}}
$$
效果:
浙公网安备 33010602011771号