Markdown使用指南
# 前言
什么是 Markdown?Markdown 是一种轻量级的「标记语言」,通常为程序员群体所用,目前它已是全球最大的技术分享网站 GitHub 和技术问答网站 StackOverFlow 的御用书写格式。 非技术类笔记用户,千万不要被「标记」、「语言」吓到,Markdown 的语法十分简单,常用的标记符号不超过十个,用于日常写作记录绰绰有余,不到半小时就能完全掌握。 就是这十个不到的标记符号,却能让人优雅地沉浸式记录,专注内容而不是纠结排版,达到「心中无尘,码字入神」的境界。
# 利用 Markdown 可以做什么?
# 标题
标题是每篇文章必备而且最常用的格式。 在 Markdown 中,如果想将一段文字定义为标题,只需要在这段文字前面加上 #,再在 # 后加一个空格即可。还可增加二、三、四、五、六级标题,总共六级,只需要增加 # ,增加一个 # ,标题字号相应降低一级。 代码如下:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
2
3
4
5
6
# 列表
列表格式也很常用,它可以让你的文稿变得井井有条。在 Markdown 中,你只需要在文字前面加上 - 就可以了;如果你希望是有序列表,在文字前面加上 1. 2. 3. 即可。
注:-、1.和文字之间要保留一个字符的空格。
无序列表
# 代码
- 列表 1
- 列表 1.1
- 列表 1.2
- 列表 2
- 列表 3
2
3
4
5
6
- 列表 1
- 列表 1.1
- 列表 1.2
- 列表 2
- 列表 3
无序列表可以用* , + , — 来创建,用在线编辑器看,实际上是转换成了 ul>li ,所以使用哪个都可以。
有序列表
# 代码
1. 列表 1
2. 列表 2
3. 列表 3
2
3
4
# 引用
如果你需要在文稿中引用一段别处的句子,那么就要用到「引用」格式。
在引用文字前加上 >
并与文字保留一个字符的空格,即可。代码如下:
> - 前方高能
> > 注意:这里是为了提醒前面有很刺激的事情发生,请做好准备。
> > 城市套路深,我要回农村。
2
3
- 前方高能
注意:这里是为了提醒前面有很刺激的事情发生,请做好准备。 城市套路深,我要回农村。
注:符号与文本之间必须空格。
由上面例子可以看出,想要在上一次引用中嵌套一层引用,只需多加一个>,理论上可以无限嵌套,我就不整那么多了,注意:多层嵌套的>
是不需要连续在一起的,只要在一行就可以了,中间允许有空格,但是为了好看,还是把排版搞好吧。
# 代码框
这个就比较重要了,很多时候都需要展示出一些代码 如果代码量比较少,只有单行的话,可以用单反引号包起来,如下: 单行用
`
<p><a href="javascript:;">气宇轩昂</a></p>
`
2
3
<p><a href="javascript:;">气宇轩昂</a></p>
要是多行这个就不行了,多行可以用这个:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title>这是title</title>
</head>
<body>
<h1>我的第一个标题</h1>
<p>我的第一个段落。</p>
</body>
</html>
2
3
4
5
6
7
8
9
10
11
多行用三个反引号,如果要写注释,可以在反引号后面写
# 链接与图片
链接:在 Markdown 中,插入链接只需要使用 [显示文本](链接地址)
即可。
图片:在 Markdown 中,插入图片只需要使用 ![显示文本](图片链接地址)
即可。
注:插入图片的语法和链接的语法很像,只是前面多了一个
!
**插入链接:**
[气宇轩昂](http://example.com/)
**插入图片:**
![这是一张图](/post/home-bg-o.jpg)
2
3
4
5
插入链接: 气宇轩昂 (opens new window)
插入图片:
上述方法只是单纯把图片显示出来,无法自定义设置图片大小,如果图片很大的话就会铺满屏幕或者超高,排版上不好看。
通过 img
标签控制宽高:
<img
src="http://pic15.photophoto.cn/20100615/0006019058815826_b.jpg"
height="330"
width="400"
/>
<!-- 或者 -->
<img src="/post/home-bg-o.jpg" style="height:200px;width:400px" />
2
3
4
5
6
7
通过 <div>
标签和 align
属性控制对齐方式:
<div style="display:flex;justify-content:center;">
<img src="/post/home-bg-o.jpg" style="width:300px;" />
<img src="/post/home-bg.jpg" style="width:300px;" />
</div>
2
3
4
# 表格
当你需要在 Markdown 文稿中键入表格,代码如下:
# 第一种写法
| name | age | sex |
| :--: | :-- | --: |
| tony | 18 | 男 |
# 第二种写法
表头1 | 表头2
---- | ----
Cell | Cell
|
# 第三种写法
学号|姓名|分数
-|-|-
001|小明|90
2
3
4
5
6
7
8
9
10
11
12
13
14
15
name | age | sex |
---|---|---|
tony | 18 | 男 |
表头 1 | 表头 2 |
---|---|
Cell | Cell |
学号 | 姓名 | 分数 |
---|---|---|
001 | 小明 | 90 |
从这 3 种不同写法看,表格的格式不一定要对的非常齐,但是为了好看,对齐肯定是最好的,第一种的分割线后面的冒号表示对齐方式,写在左边表示左对齐,右边为右对齐,两边都写表示居中,还是有点意思的。
# 强调
*字体倾斜*
_字体倾斜_
**字体加粗**
__字体加粗__
2
3
4
字体倾斜 字体倾斜 字体加粗 字体加粗
一个星号或者是一个下划线包起来,会转换为<em>
倾斜,如果是 2 个,会转换为<strong>
加粗。
# 转义
- \\
- \`
- \~
- \_
- \-
- \+
- \.
- \!
2
3
4
5
6
7
8
- \
- `
- ~
- _
- -
- +
- .
- !
就不一一列举了,基本上跟 js 转义是一样的
# 删除线
~~请删掉我吧~~
请删掉我吧
# 分割线
分割线的语法只需要另起一行,分割线可以由* - _(星号,减号,底线)这 3 个符号的至少 3 个符号表示,注意至少要 3 个,且不需要连续,有空格也可以。代码如下:
这是第一段内容
---
这是第二段内容
2
3
4
5
这是第二段内容