Markdown 使用教程
基础语法
1.目录
Markdown支持根据标题自动生成目录,对应的格式如下:
@[toc](Markdown使用手册)
效果如下图所示:
2.标题
格式一:#的使用
Markdown支持6种级别的标题,对应html标签 h1 ~ h6
# h1
## h2
### h3
#### h4
##### h5
###### h6
效果如下图所示:
格式二:= 和 - 的使用
一级标题
===
二级标题
---
效果如下图所示:
注意:格式二在文字大小控制级别是有限的。
3.段落
Markdown其实就是一种易于编写的普通文本,分段不需要使用类似P标签的标记,只需要前后两个段落至少保留一个空行就可以了。
4.区块引用
我们可能希望对某段文字进行强调处理。Markdown提供了一个特殊符号>用于对段落进行强调,被强调的文字部分将会高亮显示
> 文字会被高亮强调显示
效果如下图所示:
5.插入链接
Markdown针对链接和图片的处理可以使用下面的语法进行标记:
[点击跳转至百度](http://www.baidu.com)
效果如下图所示:
6.插入图片
![图片](https://img-blog.csdnimg.cn/20190418180149378.png)
效果如下图所示:
注: 引用图片和链接的唯一区别就是在最前方添加一个感叹号。
7.插入列表
Markdown支持有序列表和无序列表两种形式:
- 无序列表使用*或+或-再加空格表示
- 有序列表使用数字加点再加空格表示
* 张三
* 李四
* 王五
+ 苹果
+ 香蕉
+ 玉米
- 豆浆
- 油条
- 面包
1. 南瓜
2. 冬瓜
3. 黄瓜
效果如下图所示:
注:记住一个原则,如果在和列表配合使用的时候出现了问题,就缩进,四个空格或者一个制表符代表一次缩进。如果一次缩进没有解决问题,尝试使用两次。
8.分割线
为了排版漂亮,可能会加入分隔线,下面任意一种形式都可以
***
---
效果如下图所示:
注:分割线标记符号之间添加空格也可以
9.强调
如果我们希望对某一部分文字进行强调,使用*或_包裹即可。使用单一符号标记的效果是斜体,使用两个符号标记的效果是加粗
*斜体*
_斜体_
**加粗**
__加粗__
效果如下图所示:
10.插入代码块
-
单行代码
如果是行内代码引用,使用单个反引号进行包裹
~int x = 100;~
-
整段代码
如果插入一整段代码,需要至少使用两个以上反引号进行包裹~~~java public static void main(String[] args) { int sum = 0; int a = 10, b = 20; sum = a + b; } ~~~
注:很多人不知道怎么输入反引号。在英文模式下,找到键盘最左侧esc键下面的第一个键点击即可。
11.插入表格
表格是Markdown语法中比较复杂的一个,其语法如下:
表头|条目一|条目二
:---:|:---:|:---:
项目|项目一|项目二
效果如下图所示:
表头 | 条目一 | 条目二 |
---|---|---|
项目 | 项目一 | 项目二 |
注:三个短斜杠左右的冒号用于控制对齐方式,只放置左边冒号表示文字居左,只放置右边冒号表示文字居右,如果两边都放置冒号表示文字居中。
12.特殊符号
Markdown使用反斜杠\插入语法中用到的特殊符号。在Markdown中,主要有以下几种特殊符号需要处理:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
注:在内容中输入以上特殊符号的时候一定要注意转义,否则将导致内容显示不全,甚至排版混乱。
13.修改字体颜色
单纯使用Markdown设置文字颜色是做不到的,可以如下操作:
1.先用Markdown编辑完成
2.导出为html,在需要上色的部分手动添加标签
我变红了保存即可。
或者你对html代码熟悉,你完全可以使用HTML代码
随意的编辑你的Markdown文件内容了.
14.插入Html代码编辑复杂样式的Markdown
如下所示:
<table border="1" cellspacing="0px" cellpadding="10" style="border-collapse: collapse;">
<caption>表格标题</caption>
<tbody>
<tr>
<td rowspan="3" align="center">Android图书</td>
<td>Android疯狂讲义</td>
<td>李刚</td>
</tr>
<tr>
<td>从入门到精通</td>
<td>李刚2</td>
</tr>
<tr>
<td>Android</td>
<td>aaa</td>
</tr>
</tbody>
<tbody>
<tr>
<td rowspan="3" align="center">Java图书</td>
<td>Java疯狂讲义</td>
<td>李刚</td>
</tr>
<tr>
<td>Java从入门到精通</td>
<td>清华出版社</td>
</tr>
<tr>
<td>JavaCore</td>
<td>张三</td>
</tr>
</tbody>
<thead>
<tr align="center">
<td> </td>
<td>书名</td>
<td>作者</td>
</tr>
</thead>
<tfoot>
<tr>
<td colspan="3" align="right">库存:30本</td>
</tr>
</tfoot>
</table>
效果如下图所示:
Android图书 | Android疯狂讲义 | 李刚 |
从入门到精通 | 李刚2 | |
Android | aaa | |
Java图书 | Java疯狂讲义 | 李刚 |
Java从入门到精通 | 清华出版社 | |
JavaCore | 张三 | |
书名 | 作者 | |
库存:30本 |