Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。它允许人们使用易读易写的纯文本格式编写文档,然后转换成格式丰富的HTML页面,Markdown文件的后缀名便是 .md, .markdown。
Markdown 应用
Markdown 能被使用来撰写电子书,如:Gitbook。
当前许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。例如:博客园、GitHub、简书、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge等。
一、标题
一个#是一级标题,二个#是二级标题,以此类推。支持六级标题(也就是HTML代码中的h1-h6)。也可以用两个以上的=代表一级标题,两个以上的-代表二级标题,个人觉得没有用#方便。
注:标准语法一般在#后跟个空格再写文字。
代码如下:
我展示的是一级标题
====
我展示的是二级标题
--
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
效果如下:
我展示的是一级标题
我展示的是二级标题
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
二、段落
Markdown 段落没有特殊的格式,直接编写文字就好,在段落后面使用一个空行来表示重新开始一个段落。
代码如下:
第一段文字
第二段文字
效果如下:
第一段文字
第二段文字
三、字体
- 加粗
要加粗的文字左右分别用两个*号包起来
- 斜体
要倾斜的文字左右分别用一个*号包起来
- 斜体加粗
要倾斜和加粗的文字左右分别用三个*号包起来
- 高亮
要高亮的文字左右分别用两个==号包起来
- 删除线
要加删除线的文字左右分别用两个~~号包起来
代码如下:
**这是加粗的文字**
*这是倾斜的文字*
***这是斜体加粗的文字***
==这是高亮的文字==
~~这是加删除线的文字~~
效果如下:
这是加粗的文字
这是倾斜的文字
这是斜体加粗的文字
这是高亮的文字
这是加删除线的文字
四、引用
在引用的文字前加>即可。引用也可以嵌套,如加两个>>三个>>>
n个...
代码如下:
>这是引用的内容
>>这是引用的内容
>>>>>>>>>>这是引用的内容
效果如下:
这是引用的内容
这是引用的内容
这是引用的内容
五、分割线
你可以在一行中用三个以上的星号、减号、下划线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:
代码如下:
***
* * *
*****
- - -
----------
效果如下:
- 下划线
下划线可以通过 HTML 的 <u>
标签来实现:
代码如下:
<u>带下划线文本</u>
效果如下:
带下划线文本
六、图片
语法:
![图片alt](图片地址 ''图片title'')
图片alt就是如果图片地址失效时候,展示给用户对图片内容的解释。
图片title是图片的标题,当鼠标移到图片上时显示的内容。title可加可不加
代码如下:
![我的头像](https://pic.cnblogs.com/face/733258/20160909132007.png "头像")
效果如下:
七、超链接
语法:
[超链接名](超链接地址 "超链接title")
title可加可不加
示例:
[百度](http://baidu.com "百度链接")
效果如下:
注:Markdown本身语法不支持链接在新页面中打开,个别平台做了处理,是可以的。如果想要在新页面中打开的话可以用html语言的a标签代替。
代码如下:
<a href="超链接地址" target="_blank">超链接名</a>
示例
<a href="https://www.cnblogs.com/jiaoshou/" target="_blank">博客园</a>
效果如下:
示例
博客园
八、列表
无序列表写法介绍:
无序列表用 ( - + *)任何一种都可以
代码如下:
- 第一种列表写法
+ 第二种列表写法
* 第三种列表写法
注意:- + * 跟内容之间都要有一个空格
效果如下:
- 第一种列表写法
- 第二种列表写法
- 第三种列表写法
有序列表写法介绍:
有序列表用数字加点即可
代码如下:
1. 列表内容
2. 列表内容
3. 列表内容
效果如下:
1.列表内容
2.列表内容
3.列表内容
列表嵌套写法介绍:
列表嵌套只需在子列表中的选项添加四个空格即可,有序列表和无序列表写法一样:
代码如下:
1. 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
2. 第二项:
- 第二项嵌套的第一个元素
- 第二项嵌套的第二个元素
效果如下:
- 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
- 第二项:
- 第二项嵌套的第一个元素
- 第二项嵌套的第二个元素
九、表格
使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行。
语法:
表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容
我们可以设置表格的对齐方式:
- -: 设置内容和标题栏居右对齐。
- :- 设置内容和标题栏居左对齐。
- :-: 设置内容和标题栏居中对齐。
代码如下:
姓名|技能|排行
--|:--:|--:
刘备|哭|大哥
关羽|打|二哥
张飞|骂|三弟
效果如下:
姓名 | 技能 | 排行 |
---|---|---|
刘备 | 哭 | 大哥 |
关羽 | 打 | 二哥 |
张飞 | 骂 | 三弟 |
十、代码
行内代码块:代码首尾分别用一个反引号( ` )包起来即可
代码如下:
我的`代`码
效果如下:
我的代
码
单行、多行代码块:代码之间分别用三个反引号 ( ``` )包起来,且两边的反引号单独占一行
代码如下:
(```)
一行代码
两行代码
三行代码
(```)
效果如下:
一行代码
两行代码
三行代码
注:为了防止转译,前后三个反引号处加了小括号,实际是没有的。这里只是用来演示,实际中去掉两边小括号即可。
十一、高级技巧
- 支持的 HTML 元素
不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。
目前支持的 HTML 元素有:<kbd> <b> <i> <em> <sup> <sub> <br>
等(但是个别平台对html这些稀有标签未做样式处理,建议减少使用此类标签)。
代码如下:
使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑
效果如下:
Ctrl+Alt+Del 重启电脑
注:本平台就未做样式出来,但是你可以查看元素看到效果
- 支持流程图
多数平台不支持显示,暂不解释,请自行百度其他文字学习。