PS(2016.04): 三年前最开始学习 markdown 的时候记录的笔记,最近在重新整理之前的笔记,再次翻起与 markdown 相关的一系列笔记,这里重新整理一下。
基础语法规则
行内文字格式化
- 加粗:用两个
*
包裹文字即可,粗体。 - 斜体:用一个
*
包裹文字即可,斜体。 - 粗斜体:用三个
*
包裹文字即可,粗斜体。
角注
角注使用[^1]
这种方式添加[1]。具体使用方式如下:
引用角注[^1]
[^1]: 角注内容
图片和链接
- 自动链接:
<http://example.com/>
得到的是 http://example.com/ - 带文字链接:
[蘑菇街](http://www.mogujie.com)
得到的就是 蘑菇街
向页面中插入图片的方式与带文字链接类似,只不过前面多了个感叹号:
![当图片出不来显示的文字](http://upload-images.jianshu.io/upload_images/2283-476c245df0fe29fa.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
图片上带链接?只要图片整体当文字然后用文字链接的方式就可以了。
段落与换行
在 HTML 页面中,段落使用 <p></p>
标签包裹,而换行则使用 <br />
。在 Markdown 的语法中,段落直接使用空行隔开即可,而段内换行则是行最后跟两个空格,再换到下一行继续书写。示例如下:
我是一段文字
我是一段文字,但我下面还有段内换行文字
哈哈,我是段内换行的文字,你会发现上一行最后还有两个空格哦!
我是一段文字
我是一段文字,但我下面还有段内换行文字
哈哈,我是段内换行的文字,你会发现上一行最后还有两个空格哦!
标题
标题是每篇文章都需要也是最常用的格式,在 Markdown 中,如果一段文字被定义为标题,只要在这段文字前加 #
号即可。几级标题加几个 #
号。示例如下:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
注:不推荐无节制地加标题,每个项目最好提前约定好标题级数的使用规范。
引用区块
在 HTML 页面中,引用区块使用的是 blockquote
标签,Markdown 语法提供了一种更方便的方式,效果其实前面的注中已经展现了,在要引用的段文字最前加 >
即可。(如果有多段,则每一段最前都要加)
> 我是引用内容
>
> 我也是引用内容
我是引用内容
我也是引用内容
列表
列表包括有序列表和无序列表,有序列表用数字开头,而无序列表使用 *
或 -
或 +
开头,之后跟一个空格再添加内容,子列表需要相对父列表向右多两个空格且不能加空行。示例如下:
无序列表:
- 无序列表1
+ 无序子列表
- 无序列表2
- 无序列表1
- 无序子列表
- 无序列表2
有序列表:(事实上,只要是数字就行,无需关注顺序,即便先写 2 再写 1 最终得到的也是按顺序排列的列表)
2. 有序列表1
a. 有序子列表
1. 有序列表2
- 无序列表1
- 无序
- 无序列表2
如果列表之间加了空行,就会被解释成两段内容,也许得到的就并不是你想要的了。
代码块
代码块分两种,内联代码及块代码,对应于 HTML 中的 code
和 pre
标签。内联代码很简单,用 ` 号(键盘上数字 1 左边那个键)包裹起来即可。而块代码则有两种方式:
使用三个 ` 来包裹代码块,这种方式可以自定义语法高亮
-
将代码块向右缩进四个空格,这种方式不会带任何语法高亮
```javascript console.log('hello world'); ```
这时,你看到的效果会是:
console.log('hello world');
分隔线
当一行元素为 * * *
的时候,就是下面这种效果的分隔线了:
-
角注 ↩