Markdown简明教程
-
Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。
-
Markdown 语言在 2004 由约翰·格鲁伯(英语:John Gruber)创建。
-
Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。
-
Markdown 能被使用来撰写电子书,如Gitbook。当前许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。例如:GitHub、简书、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge等。
-
Markdown 编写的文档后缀一般为
.md
。
标题
使用#
号可表示1-6级标题,一级标题用#
号,二级标题对应两个#
号,以此类推。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
#### 五级标题
###### 六级标题
段落格式
1 . 段落
Markdown 段落没有特殊的格式,直接编写文字就好,段落的换行是使用两个以上空格加上回车。
2. 字体
*斜体文本*
**粗体文本**
***粗体斜文本***
显示结果如下:
斜体文本
粗体文本
粗体斜文本
3 . 分割线
可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:
***
* * *
*****
- - -
-----------
显示效果如下:
4. 删除线
如果段落上的文字要添加删除线,只需要在文字的两端加上两个波浪线~~
即可
RUNOOB.COM
GOOGLE.COM
~~BAIDU.COM~~
显示效果为:
RUNOOB.COM
GOOGLE.COM
BAIDU.COM
5 . 下划线
- 下划线可以通过 HTML 的
<u>
标签来实现:
<u>我的未来不是梦</u>
- 显示效果如下:
我的未来不是梦
6 . 脚注
-
脚注是对文本的补充说明。
-
Markdown 脚注的格式如下:
[^要注明的文本]
- 以下实例演示了脚注的用法:
创建脚注格式类似这样 [^RUNOOB]。
[^RUNOOB]: 学的不仅是技术,更是梦想!!!
演示效果如下:
创建脚注格式类似这样 1。
列表
- 无序列表
无序列表使用星号*
、加号+
或是减号-
作为列表标记,这些标记后面要添加一个空格,然后再填写内容:
* 第一项
* 第二项
* 第三项
+ 第一项
+ 第二项
+ 第三项
- 第一项
- 第二项
- 第三项
显示结果如下:
- 第一项
- 第二项
- 第三项
- 第一项
- 第二项
- 第三项
-
第一项
-
第二项
-
第三项
-
有序列表使用数字并加上
.
号来表示
1. 第一项
2. 第二项
3. 第三项
显示结果如下:
- 第一项
- 第二项
- 第三项
- 列表嵌套
1. 第1项:
- 第1项嵌套的第1个元素
- 第1项嵌套的第2个元素
2. 第2项:
- 第2项嵌套的第1个元素
- 第2项嵌套的第2个元素
显示结果如下:
- 第1项:
- 第1项嵌套的第1个元素
- 第1项嵌套的第2个元素
- 第2项:
- 第2项嵌套的第1个元素
- 第2项嵌套的第2个元素
区块
- 区块引用是在段落开头使用
>
符号 ,然后后面紧跟一个空格符号。
> 区块学习
> 实现自我
> 畅想未来
区块学习
实现自我
畅想未来
-区块是可以嵌套的,一个>
符号是最外层,两个 >
符号是第一层嵌套,以此类推:
> 最外层
> > 第一层嵌套
> > > 第二层嵌套
显示结果如下:
最外层
第一层嵌套
第二层嵌套
- 区块中使用列表
> 区块中使用列表
> 1. 第一项
> 2. 第二项
> + 第一项
> + 第二项
> + 第三项
显示结果如下:
区块中使用列表
- 第一项
- 第二项
- 第一项
- 第二项
- 第三项
- 列表中使用区块
如果要在列表项目内放进区块,那么就需要在>
前添加四个空格的缩进.
* 第一项
> 菜鸟教程
> 学的不仅是技术更是梦想
* 第二项
显示结果如下:
- 第一项
菜鸟教程
学的不仅是技术更是梦想 - 第二项
代码
- 如果是段落上的一个函数或片段的代码可以用反引号把它包起来(`),例如:
`printf()` 函数的使用方法
显示结果如下:
printf()
函数的使用方法
- 也可以用 ```包裹一段代码,并指定一种语言(也可以不指定)
# including<iostream>
using namespace std;
int main(){
cout<<"Hello world!"<<endl;
}
链接
链接使用方法如下:
(1)
[链接名称](链接地址)
或者
<链接地址>
例如:
这是百度链接 [百度一下](https://www.baidu.com)
显示结果如下:
这是百度链接 百度一下
(2)
直接使用链接地址:
https://www.baidu.com
(3)
高级链接
可以通过变量来设置一个链接,变量赋值在文档末尾进行:
这个百度链接用 1 作为网址变量 [Baidu][1]
这个链接用 2作为网址变量 [ECNU][2]
然后在文档的结尾为变量赋值(网址)
[1]: http://www.baidu.com/
[2]: http://www.ecnu.edu.com/
这个百度链接用 1 作为网址变量 [Baidu][1]
这个链接用 2作为网址变量 [ECNU][2]
然后在文档的结尾为变量赋值(网址)
[1]: http://www.baidu.com/
[2]: http://www.ecnu.edu.com/
图片
- 插入本地图片
只需要在基础语法的括号中填入图片的位置路径即可,支持绝对路径和相对路径.
![Alt text](图片链接 "optional title")
- 插入网络图片
在基础语法的括号中填入图片的网络链接即可,现在已经有很多免费/收费图床和方便传图的小工具可选.
![avatar](http://....../***/***.png)
或者
表格
Markdown 制作表格使用 |
来分隔不同的单元格,使用 -
来分隔表头和其他行。
语法格式如下:
| 表头1 | 表头2 |
| ---- | ---- |
| A | B |
| C | D |
显示结果如下:
表头1 | 表头2 |
---|---|
A | B |
C | D |
对齐方式
可以设置表格的对齐方式:
- —: 设置内容和标题栏居右对齐。
- :— 设置内容和标题栏居左对齐。
- :—: 设置内容和标题栏居中对齐
实例:
| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
显示如下:
左对齐 | 右对齐 | 居中对齐 |
---|---|---|
单元格 | 单元格 | 单元格 |
单元格 | 单元格 | 单元格 |
高级技巧
- 转义
Markdown 使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用转义字符,Markdown 使用反斜杠转义特殊字符:
**文本加粗**
\*\* 正常显示星号 \*\*
显示如下:
文本加粗
** 正常显示星号 **
-Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
\ 反斜线
` 反引号
* 星号
_ 下划线
{} 花括号
[] 方括号
() 小括号
# 井字号
+ 加号
- 减号
. 英文句点
! 感叹号
** 公式**
Markdown Preview Enhanced 使用 KaTeX 或者 MathJax 来渲染数学表达式。
KaTeX 拥有比 MathJax 更快的性能,但是它却少了很多 MathJax 拥有的特性。你可以查看 KaTeX supported functions/symbols 来了解 KaTeX 支持那些符号和函数。
默认下的分隔符:
$...$ 或者 \(...\) 中的数学表达式将会在行内显示。
$$...$$ 或者 \[...\] 或者 ```math 中的数学表达式将会在块内显示。
**不足之处,后续完善。。。。。。。**
声明:以上内容转载自:https://www.runoob.com/markdown/md-tutorial.html,仅用于学习交流,勿用于商业用途。
学的不仅是技术,更是梦想!!! ↩︎