MarkDown标记语言语法

2013-05-22  本文已影响111人  Tsung

PS(2016.04): 三年前最开始学习 markdown 的时候记录的笔记,最近在重新整理之前的笔记,再次翻起与 markdown 相关的一系列笔记,这里重新整理一下。

基础语法规则

行内文字格式化

  1. 加粗:用两个 * 包裹文字即可,粗体
  2. 斜体:用一个 * 包裹文字即可,斜体
  3. 粗斜体:用三个 * 包裹文字即可,粗斜体

角注

角注使用[^1]这种方式添加[1]。具体使用方式如下:

引用角注[^1]

[^1]: 角注内容

图片和链接

向页面中插入图片的方式与带文字链接类似,只不过前面多了个感叹号:

![当图片出不来显示的文字](https://img.haomeiwen.com/i2283/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. 无序列表1
  • 无序
  1. 无序列表2

如果列表之间加了空行,就会被解释成两段内容,也许得到的就并不是你想要的了。

代码块

代码块分两种,内联代码及块代码,对应于 HTML 中的 codepre 标签。内联代码很简单,用 ` 号(键盘上数字 1 左边那个键)包裹起来即可。而块代码则有两种方式:

  1. 使用三个 ` 来包裹代码块,这种方式可以自定义语法高亮

  2. 将代码块向右缩进四个空格,这种方式不会带任何语法高亮

     ```javascript
     console.log('hello world');
     ```    
    

这时,你看到的效果会是:

console.log('hello world');

分隔线

当一行元素为 * * * 的时候,就是下面这种效果的分隔线了:



  1. 角注

上一篇下一篇

猜你喜欢

热点阅读