MarkDown 概述
宗旨
MarkDown 的目标是实现「易读易写」。
一份使用 MarkDown 格式撰写的文件应该可以直接以纯文本发布,并且看起来不会像是由许多标签或是格式指令所构成。
兼容 HTML
MarkDown 语法的目标是:成为一种适用于网络的书写语言。
MarkDown 的构想不是要使得 HTML 文档更容易书写。MarkDown 的设计理念是,能让文档更容易读、写和随意改。
标题
MarkDown 标题有两种格式:
- 使用 = 和 - 标记一级和二级标题。
我展示的是一级标题
=================
我展示的是二级标题
-----------------
- 使用 # 号可表示 1-6 级标题,一级标题对应一个 # 号,二级标题对应两个 # 号,以此类推。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
段落与文本换行
Markdown 段落没有特殊的格式,直接编写文字, 段落换行是使用两个以上的空格加上回车/使用一个空行重新开始一个新的段落/使用 HTML 标签 <br>
。
1. 段落 (两个空格+回车)
2. <br> 段落 </br>(使用 HTML 语言换行标签)
文本添加缩进
#使用 HTML 标签 <style> 实现
<p style="text-indent:1em">你好呀</p>
<p style="text-indent:2em">你好呀</p>
你好呀
你好呀
字体
MarkDown 可以使用以下几种字体:
*斜体文本*
**粗体文本**
***粗斜体文本***
高亮
MarkDown 使用连续两个单号包括高亮的部分实现内容的高亮。
==高亮内容==
分割线
在一行中用三个以上的 星号、减号、底线 来建立一个分隔线,行内不能有其他东西或在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:
- ***
- ---
- ···
删除线
如果段落上的文字要添加删除线,只需要在文字的两端加上两个波浪线即可。
~~delete
下划线
下划线可以通过 HTML 的标签来实现。
<u>带下划线文本</u>
注释
使用 HTML 的注释方式。
<!-- 注释 -->
脚注
脚注是对文本的补充说明,MarkDown 脚注标识可以为字母数字下划线,但是暂不支持中文。脚注内容可为任意字符,包括中文。
创建脚注格式 [^1]
[^1] : 菜鸟教程 -- 学的不仅是技术,更是梦想!
文本居中
使用 HTML 可以将文本居中。
<center>居中的内容</center>
列表
MarkDown 支持有序列表和无序列表。
- 有序列表
有序列表使用数字并加上 . 号来表示。
1. 第一项
2. 第二项
3. 第三项
- 无序列表
无序列表使用 星号 ( *
)、加号 ( +
)或是 减号 ( -
)作为列表标记。
* 第一项
* 第二项
* 第三项
------ 分割线 ------
- 第一项
- 第二项
- 第三项
------ 分割线 ------
+ 第一项
+ 第二项
+ 第三项
区块
- 区块引用
MarkDown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟 一个空格符号 。
> 区块引用
> 菜鸟教程
> 学的不仅是技术更是梦想
- 区块使用列表
> 区块中使用列表
> 1. 第一项
> 2. 第二项
> + 第一项
> + 第二项
> + 第三项
- 列表中使用区块
如果要在列表项目内放进区块,那么就需要在 > 前添加四个空格的缩进。
* 第一项
> 菜鸟教程
> 学的不仅是技术更是梦想
* 第二项
>欢迎光临
代码与代码块
- 单行代码
如果是单行代码或段落上的一个函数或片段的代码可以用 反引号对 把它括起来。
fmt.Println("Hello Word!)
- 代码区块
代码区块使用 三个反引号对 包裹一段代码,并指定一种语言(也可以不指定)。
#include <stdio.h>
int main(){
printf("Hello World!\n");
return 0;
}
上标与下标
- 上标使用双 ^ 括住内容
x^2^
- 下标使用双 ~ 括住内容
H2~0~
超链接
-
一个方括号 [] ,里面放上链接的替代文字
-
接着一个普通括号 () ,里面放上网址
链接也可以用变量来代替,文档末尾附带变量地址:
这个链接用 1 作为网址变量 [Google][1]
这个链接用 baidu 作为网址变量 [百度][baidu]然后在文档的结尾为变量赋值(网址)[1]:http://www.google.com/
[baidu]:http://www.baidu.com/
插入图片
-
开头一个 感叹号 ! 。
-
接着一个 方括号 [] ,里面放上图片的替代文字。
-
接着一个 普通括号 () ,里面放上图片的网址,最后还可以用 引号 包住并加上选择性的 title 属性的文字。
![图片](http://www.baidu.com/img/logo.png)
设置图片
通过 center 居中,把 center 换成 left 和 right 可以实现居左或者居右,width 和 height 调控高度和宽度。
<div align=center><img src="https://i-blog.csdnimg.cn/blog_migrate/714b1fac576603ac8efe92140d138537.jpeg" width="251" height="350"></div>
![](https://i-blog.csdnimg.cn/blog_migrate/714b1fac576603ac8efe92140d138537.jpeg)
插入视频
插入视频实现依赖于 HTML 。
<video controls="" autoplay="" name="media">
<source src="https://www.w3school.com.cn/example/html5/mov_bbb.mp4" type="video/mp4">
</video>
<iframe width=100% height=120px src='//player.bilibili.com/player.html?aid=455564468&bvid=BV1H541147nA&cid=187808769&page=1' frameborder="0" allowfullscreen>
</iframe>
-
src 里面填视频原 URL 。
-
width 是视频宽度(可以填百分比)。
-
height 是视频高度(可以填百分比)。
插入音乐
插入音乐实现依赖于 HTML 。
<div align=center>
<iframe frameborder="no" marginwidth="0" marginheight="0" width=300 height=90 src="https://music.163.com/outchain/player?type=2&id=34341360&auto=0&height=66"></iframe>
</div>
-
div 用于控制格式,若无则默认为居左。
-
frameborder 用于规定是否显示框架周围的边框,1 为是,0 为否。
-
marginwidth 及 marginheight 表示距离边缘的像素大小。
-
width 及 height 表示播放条的长度和宽度 src 为播放链接,可以在如网易云音乐的生成外链播放器获取该链接,同时也获得以下代码,并可以自行更改;也可将音频链接改为视频链接,从而播放视频。
插入表格
输入 |
表头1 |
表头2 |
并回车,即可创建一个包含 2 列表。
| 左对齐 | 右对齐 | 中对齐 |
| :---- | ----: | :---: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
-
第一行为表头,第二行为分割表头和主体部分,第三行开始每一行为一个表格行。
-
列与列之间用管道符号
|
隔开,如果不使用对齐标记,内容默认左对齐,表头居中对齐。
-: 设置内容和标题栏居右对齐。
:- 设置内容和标题栏居左对齐。
:-: 设置内容和标题栏居中对齐。
-
为了美观,可以使用空格对齐不同行的单元格,并在左右两侧都使用
|
来标记单元格边界。 -
为了使 MarkDown 更清晰,
|
和-
两侧需要至少有一个空格(最左侧和最右侧的|
外不需要)。
MarkDown 编写博文的更多技巧
1. 支持 HTML 元素
不在 MarkDown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。
2. 转义
MarkDown 使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用转义字符,MarkDown 使用反斜杠转义特殊字符。
MarkDown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
- \ 反斜线
- ` 反引号
- 星号 [*]
- 下划线
- {} 花括号
- [] 方括号
- () 小括号
- # 井字号
- + 加号
- - 减号
- . 英文句点
- ! 感叹号
文字颜色、大小、字体背景色
1. 字体大小
size为1:<font size="1">size为1</font>
size为3:<font size="3">size为3</font>
size为4:<font size="4">size为4</font>
size为6:<font size="6">size为6</font>
size为1:size为1
size为3:size为3
size为4:size为4
size为6:size为6
2.颜色
<font color="#dd0000">文字颜色</font>
文字颜色
3.背景色
MarkDown 本身不支持背景色设置,需要采用内置 HTMML 的方式实现:借助 table
, tr
, td
等表格标签的 bgcolor 属性来实现背景色的功能。
<table><tr><td bgcolor=orange>背景色是:orange</td></tr></table>
<table><tr><td bgcolor=#FF00FF>背景色的设置是按照十六进制颜色值:#7FFFD4</td></tr></table>
<table><tr><td bgcolor=#FF83FA>背景色的设置是按照十六进制颜色值:#FF83FA</td></tr></table>
<table><tr><td bgcolor=#D1EEEE>背景色的设置是按照十六进制颜色值:#D1EEEE</td></tr></table>
<table><tr><td bgcolor=#C0FF3E>背景色的设置是按照十六进制颜色值:#C0FF3E</td></tr></table>
<table><tr><td bgcolor=#54FF9F>背景色的设置是按照十六进制颜色值:#54FF9F</td></tr></table>
背景色是:orange |
背景色的设置是按照十六进制颜色值:#7FFFD4 |
背景色的设置是按照十六进制颜色值:#FF83FA |
背景色的设置是按照十六进制颜色值:#D1EEEE |
背景色的设置是按照十六进制颜色值:#C0FF3E |
背景色的设置是按照十六进制颜色值:#54FF9F |
使用 LaTex 数学公式
1.行内公式
使用两个 $ 符号引用公式。
$公式$
2.行间公式
使用两对 $$ 符号引用公式。
$$公式$$
在 MarkDown 数学符号官网使用中,详细介绍了一些常用的数学公式。
- 参考 MarkDown 中文网