MarkDown 基本语法

发表于 | 分类于
MarkDown 基本语法汇总

前言

看到同事用 [git+github+markdown+jekyll] 搭建了一个个人博客， 感觉很不错，果断 fork 他的分支，给自己来一个，下面简单记一些 [markdown]的语法，或者说占位符的用法

MarkDown 基本语法

标题：

1. 在文字标题之前加上 “#” 表示标题， 通过 “#” 的数量表示标题等，一个”#”表示一级，两个表示二级，最多六级

例：# 用"#"表示标题
   # 一级标题
   ## 二级标题
   ...
   ####### 六级标题

一级标题

二级标题

…

六级标题

2. 在文字下方加上两个以上的 “-“ 表示标题, 等同于二级标题 (“##”)

  例： 在文字下方加上两个以上 "-" 表示标题
----------------------------------

两个以上 ‘-‘ 表示二级标题

3. 在文字下方加上两个以上的 “=” 表示标题，等同于一级标题 (“#”)

    例：在文字下方加上 "=" 表示标题(两个以上"=")
=======================

两个以上 ‘=’ 表示一级标题

粗体

1. 在 文字 前后 加上 两个 ‘_’ 或 ‘*’

例：__n__  或 **n**

粗体

斜体

1. 在文字前后加上一个 ‘_’ 或 ‘*’

例： _斜体_ 或 *斜体*

_斜体_

粗斜体

1. 在文字前后加上三个 ‘_’ 或 ‘*’

例： ___斜粗体___ 或 ***斜粗体***

粗斜体 粗斜体

代码块

1. 行首加上四个 Tab 或 四个空格 (代码块自带滚动条效果)

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-------------------------------------------------------------
------------------
-------

区块引用

1. 文字前面加上 “>”

例： > 这个一个区块引用

区块引用效果如下

2. 区块引用可以嵌套使用

例：
> 这是外层
>> 这是内层
>>> 这里更内层

示例效果：

这里外层

这是内层

这是更内层
这也是内层

注意
如果 > 和 >> 嵌套使用的话，从 >> 退到 > 时，必须之间要加一个空格或者 > 作为过渡，否则默认为下一行和上一行是同一级别的引用。如示例所示。
示例效果：

这里外层

这是内层

这是更内层

这也是内层

分割线

1. 三个以上”-“

例： ----

示例效果如下

2. 三个以上”*”

例： ***

示例效果如下

代码块和语法高亮

1. 代码块使用方法如下：

1
echo("this a js code Block");

代码块效果如下

1
2
var tip = "this a js code block";
echo(tip);

2. 代码块语法高亮 在 “
后加上 language
1
2
3
4
```java
public static void main(String[] args) {
    System.out.println("hello markdown");
}

3. 高亮部分文字

`高亮部分`

高亮效果示例

超链接

1. “[链接显示文字](url “超链接标题”)“ url 和标题之间有空格

例： [百度](http://www.baidu.com "百度")

示例效果: 百度

2. 指向本地文件的链接

例: [icon.png](/assets/picture/headPicture.png)

icon.png

图片引用

1. 图片引用使用方法如下

例： ![图片](图片路径 "图片标题")

图片

转义字符

1. 在需要转义的字符前面加上’\’

例： 这是用来 _演示_ 的 **文本**

    这是用来 \_演示\_ 的 \**文本\**

这是用来 _演示_ 的 文本

这是用来 _演示_ 的 **文本**

删除线

1. 在文字前后加上两个 ‘~’

例： ~~删除线~~

示例效果
删除线

表格

1. 使用 | 来分隔不同的单元格，使用 - 来分隔表头和其他行：

例：
| name | age |
| ---- | --- |
| zero | 24  |
| liam | 23  |

示例效果：

name age
zero 24
liam 23

2. 表格对其, 在表头和其他行的分隔符中加上 ‘:’

‘:—‘ 左对齐
‘:–:’ 居中
‘—:’ 右对齐
例：
| left | center | right |
| :--- | :----: | ----: |
|左    |中     |右     |

示例效果:

left center right
左 中 右

上标和下标

1. 上标 使用html标签 <sup>

例： 来个上标 <sup>[1]</sup>

示例效果:

来个上标[1]

2. 下标 使用html 标签 <sub>

例: 来个下标 <sub>[2]</sub>

示例效果:

来个下标[2]