Markdown使用教程
Markdown介绍
Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。
Markdown 语言在 2004 由约翰·格鲁伯(英语:John Gruber)创建。
Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。
Markdown 编写的文档后缀为 .md, .markdown。
Markdown应用
许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。例如:GitHub、简书、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge等
Markdown 编辑器
Markdown常用编辑器Typora,功能强大。
Typora 官网:https://typora.io/
你也可以使用我们的在线编辑器来测试:https://c.runoob.com/front-end/712。
一、Markdown 标题
1.1、使用=和-标记一级和二级标题
使用方法:
一级标题展示
=======
二级标题展示
--------
效果呈现:
一级标题展示
二级标题展示
1.2、使用# 号标记
使用方法:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
效果呈现:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
二、Markdown 段落
段落:使用两个以上的空格加回车。也可以使用一个空行表示
2.1、Markdown 字体
使用方法:
*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___
效果呈现:
斜体文本
斜体文本
粗体文本
粗体文本
粗斜体文本
粗斜体文本
2.2、Markdown 分割线
使用方法:
可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。
***
* * * *
----
------------------
效果呈现:
2.3、Markdown 删除线
使用方法:
段落上的文字需要加删除线,只需要在文字两端加上两个波浪线。
假如给我~~三天~~光明
效果呈现:
假如给我
三天光明
2.4、Markdown下划线
使用方法:
通过HTML的<u>实现
<u>带下划线的文本</u>
效果呈现:
<u>带下划线的文本</u>
2.5、Markdown 脚注
使用方法:
脚注是对文本的补充说明
创建脚注格式类似这样 [^baidu]。
[^baidu]: 百度一下 -- 哪里不会搜哪里!!!
效果呈现:
创建脚注格式类似这样 [1]。(脚注在文章最后)
三、Markdown 列表
3.1、无序列表
使用方法:
使用*、+、-作为标记,后面要添加一个空格,然后写内容。
* 第一项
* 第二项
* 第三项+ 第一项
+ 第二项
+ 第三项- 第一项
- 第二项
- 第三项
效果呈现:
- 第一项
- 第二项
- 第三项
- 第一项
- 第二项
- 第三项
- 第一项
- 第二项
- 第三项
3.2、有序列表
使用方法:
使用数字并加上.号来表示
- 第一项
- 第二项
- 第三项
效果呈现:
- 第一项
- 第二项
- 第三项
3.3、列表嵌套
使用方法:
列表嵌套只需在子列表中的选项前添加四个空格。
- 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素- 第二项:
- 第二项嵌套的第一个元素
- 第二项嵌套的第二个元素
效果呈现:
- 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
- 第二项:
- 第二项嵌套的第一个元素
- 第二项嵌套的第二个元素
四、Markdown 区块
4.1、区块
使用方法:
在段落开头使用>符号,加空格。
> 这是一个区块
效果呈现:
这是一个区块
4.2、区块嵌套
使用方法:
一个>是最外层,两个>>是里面一层
>最外层
>>第二层
>>>第三层
效果呈现:
最外层
第二层
第三层
4.3、区块中使用列表
使用方法:
- 第一项
- 第二项
+ 第一项
+ 第二项
+ 第三项
效果呈现:
- 第一项
- 第二项
- 第一项
- 第二项
- 第三项
4.4、列表中使用区块
使用方法:
需要在>前添加4个空格缩进
* 第一项
(此处4空格)> 菜鸟教程
(此处4空格)> 学的不仅是技术更是梦想
* 第二项
效果呈现:
- 第一项
菜鸟教程
学的不仅是技术更是梦想 - 第二项
五、Markdown 代码
5.1、代码
使用方法:
如果是段落上的一个函数或片段的代码可以用反引号把它包起来(`)。
'print()' 函数
效果呈现:
这是一个代码'print()' 函数
5.2、代码区块
使用方法:
前面添加4个空格或者两个制表符。
print('hello word!')
效果呈现:
print('hello word!')
5.3、指定语言
使用方法:
也可以使用'''代码'''包裹住一段代码,并指定一种语言。
'''Python
def add(a,b):
return a+b
'''
效果呈现:
'''Python
def add(a,b):
return a+b
'''
六、Markdown 链接
6.1、链接
使用方法:
[链接名称](链接地址)
<链接地址>
这是一个链接[简书](https://www.jianshu.com/)
也可以直接使用链接地址
<https://www.jianshu.com/>
效果呈现:
这是一个链接简书
6.2、高级链接
使用方法:
通过变量来设置一个链接,变量赋值在文档末尾进行。
这个链接用 1 作为网址变量 [Google][1]
然后在文档的结尾为变量赋值(网址)
[1]: http://www.google.com/
效果呈现:
这个链接用 1 作为网址变量 Google
然后在文档的结尾为变量赋值(网址)
七、Markdown 图片
7.1、使用链接
使用方法:
格式:
![alt 属性文本](图片地址)
![alt 属性文本](图片地址 "可选标题")
- 开头一个感叹号!
- 接着一个方括号,里面是图片名字。
- 接着放一个普通括号,里面放上图片网址,还可以用因拥包住并加上选择性的title属性文字。
效果呈现:
简书图标
作者头像
7.2、使用变量
也可以像网址那样对图片使用变量
使用方法:
这个链接用 1 作为网址变量 [Google][1]
然后在文档的结尾为变量赋值(网址)
[1]: https://www.google.cn/landing/cnexp/google-search.png
效果呈现:
这个链接用 1 作为网址变量 Google
然后在文档的结尾为变量赋值(网址)
八、Markdown 表格
8.1、表格
使用方法:
使用|来分割不同的单元格,使用-来分割表头和其他行。
| 表头 | 表头 |
| ---- | ---- |
| 单元格 | 单元格 |
| 单元格 | 单元格 |
效果呈现:
表头 | 表头 |
---|---|
单元格 | 单元格 |
单元格 | 单元格 |
8.2、对齐方式:
使用方法:
- -: 设置内容和标题栏居右对齐。
- :- 设置内容和标题栏居左对齐。
- :-: 设置内容和标题栏居中对齐。
| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
效果呈现:
左对齐 | 右对齐 | 居中对齐 |
---|---|---|
单元格 | 单元格 | 单元格 |
单元格 | 单元格 | 单元格 |
九、Markdown 高级技巧
9.1、支持HTML元素
使用方法:
支持的元素有:<kbd><b><i><em><sup><br><sub>等。
使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑
效果呈现:
使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑
9.2、转义
使用方法:
使用反斜杠转义
**文本加粗**
\*\* 正常显示星号 \*\*
效果呈现:
文本加粗
** 正常显示星号 **
9.3、公式
使用方法:
需要插入数学公式时,可以使用两个美元符号$$包裹数学公式。需要进行渲染。
$$
\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)}}
$$
效果呈现:
-
百度一下 -- 哪里不会搜哪里!!! ↩