Markdown教程
Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。
Markdown 语言在 2004 由约翰·格鲁伯(英语:John Gruber)创建。
Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。
Markdown 编写的文档后缀为 .md, .markdown。
Markdown应用
Markdown 能被使用来撰写电子书,如:Gitbook。
当前许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。例如:GitHub、简书、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge等。
编辑器
本教程将使用 Typora 编辑器来讲解 Markdown 的语法,Typora 支持 MacOS 、Windows、Linux 平台,且包含多种主题,编辑后直接渲染出效果。
支持导出HTML、PDF、Word、图片等多种类型文件。
Typora 官网:https://typora.io/
代码测试实例
age = 15
if age >= 18:
print("成年")
else:
print("未成年")
1.Markdown标题
使用 # 号标记
使用#号可以表示1-6级标题,一级标题使用一个#号,二级标题使用两个#号,以此类推。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
注:Ctrl+/可在原样显示与实际效果之间切换
显示效果如下:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
2.代码块(代码引用)
语法:
```代码对应的语言
被引入的代码块
```
以下是python中if语句的应用实例:
score = 80
if score >= 60:
print('及格')
else:
print('不及格')
3.文字效果
3.1引用效果
语法:
`被引用的文字`
显示效果如下:
今天的天气很好,我带着孩子们来
郊外春游
3.2加粗、斜杠和删除线
语法:
**需要加粗的文字** (快捷键: Ctrl+b)
*需要倾斜的文字* (快捷键: ctrl+i)
***需要倾斜+加粗的文字*** 快捷键:Ctrl+b后ctrl+i
~~删除线~~
显示效果如下:
今天的天气很好,我带着孩子们来郊外春游
今天的天气很好,我带着孩子们来郊外春游
今天的天气很好,我带着孩子们来***郊外春游***
今天的天气很好,我带着孩子们来郊外春游
3.3加html代码(了解)
3.3.1 Markdown语法中兼容HTML的语法:
你看,我是<span style="color:green;font-weight:bold;font-size :25px">绿色,而且加粗变高</span>的。
显示效果如下:
<center>你看,我是<font style='color:red;font-weight:bold;font-size:25px'>红色,而且加粗变高</font>还居中。</center>
显示效果如下:
3.3.2 对齐方式:
1| <c1 ter>行中心对齐</center>
2| <p align="left">行左对齐</p>
3| <p align="right">行右对齐</p>
显示效果如下:
行左对齐
行右对齐
4.列表
语法:
Markdown 支持有序列表和无序列表。
4.1 无序列表
语法:
无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记。
* 列表元素
+ 列举元素
- 列举元素
课程列表:
- 前端
- html5
- css
- js
- jQuery
- Vue.js
- python全栈
- Java分布式
- 测试
4.2有序列表
1. 列表内容
2. 列表内容
3. 列表内容
注意:序号跟内容之间要有空格,敲击两次回车就可结束当前自动生成序号。
显示效果如下:
- 语言基础
- web前端
- Linux
- 数据库
web前端课程:
- HTML5
- CSS
- js
- jQuery
3.3列表嵌套
下一级之前敲Tab即可,往回删可取消
-
一级无序列表内容
- 二级无序列表内容
- 三级无序列表内容
- 二级无序列表内容
- 二级无序列表内容
- 二级无序列表内容
5.图片
5.1 插入网络中的图片
语法:
![](图片路径)
![](https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png)
显示效果如下:
5.2 或者直接把文件拖拽进来
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-MQruznvD-1591633477604)(C:\Users\Administrator\Desktop\宝儿姐.png)]
6.超链接
6.1 超链接
语法:
[点击后可以跳转的文字](点击文字后需要跳转的目的网页网址)
注:Ctrl+鼠标点击来访问该链接
想要了解详情,请进入python官网
6.2高级链接
我们可以通过变量来设置一个链接,变量赋值在文档末尾进行:
这个链接用 1 作为网址变量 [Google][1]
这个链接用 baidu 作为网址变量 [baidu][2]
然后在文档的结尾为变量赋值(网址)
[1]: http://www.google.com/
[runoob]: http://www.baidu.com/
这个链接用 1 作为网址变量 Google
这个链接用 2 作为网址变量 baidu
然后在文档的结尾为变量赋值(网址)
7.表格
语法:
|表头1|表头2|表头3|...以此类推
|----|:--:|---:|...
|数据1|数据2|数据3|...
| | | |
| | | |
---- -> 左对齐
:--: -> 居中
---: -> 右对齐
姓名 | 性别 | 年龄 | 籍贯 |
---|---|---|---|
张三 | 男 | 18 | 北京 |
王麻子 | 男 | 20 | 成都 |
8.Markdown 高级技巧
支持的 HTML 元素
不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。
目前支持的 HTML 元素有:
使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑
使用 Ctrl+Alt+Del 重启电脑
转义
Markdown 使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用转义字符,Markdown 使用反斜杠转义特殊字符
**文本加粗**
\*\* 正常显示星号 \*\*
文本加粗
** 正常显示星号 **
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
\ 反斜线
` 反引号
* 星号
_ 下划线
{} 花括号
[] 方括号
() 小括号
# 井字号
+ 加号
- 减号
. 英文句点
! 感叹号
d>Alt+Del 重启电脑