Markdown基本语法

字数统计: 1.9k阅读时长: 7 min
2019/01/11 Share

Markdown是一种纯文本格式的标记语言。通过简单的标记语法,它可以使普通文本内容具有一定的格式。
相比WYSIWYG编辑器
优点:
1、因为是纯文本,所以只要支持Markdown的地方都能获得一样的编辑效果,可以让作者摆脱排版的困扰,专心写作。
2、操作简单。比如:WYSIWYG编辑时标记个标题,先选中内容,再点击导航栏的标题按钮,选择几级标题。要三个步骤。而Markdown只需要在标题内容前加#即可
缺点:
1、需要记一些语法(当然,是很简单。五分钟学会)。
2、有些平台不支持Markdown编辑模式。

一、标题

在想要设置的文字前面加#来表示
一级标题一个#,二级标题两个##,以此类推,最多支持6级标题

注:标准语法一般在#后跟个空格再写文字,貌似简书不加空格也行。

示例:

1
2
3
4
5
6
# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题

效果如下:

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题
这是六级标题

二、字体

  • 加粗

    要加粗的文字左右分别用两个*号包起来

  • 斜体

    要倾斜的文字左右分别用一个*号包起来

  • 斜体加粗

    要倾斜和加粗的文字左右分别用三个*号包起来

  • 删除线

    要加删除线的文字左右分别用两个~~号包起来

    示例:

    1
    2
    3
    4
    **这是加粗的文字**
    *这是倾斜的文字*`
    ***这是斜体加粗的文字***
    ~~这是加删除线的文字~~

    效果如下:
    这是加粗的文字
    这是倾斜的文字`
    这是斜体加粗的文字
    这是加删除线的文字

三、引用

在引用的文字前加>即可。引用也可以嵌套,如加两个>>三个>>>
n个…
貌似可以一直加下去,但没神马卵用

示例:

1
2
3
>这是引用的内容
>>这是引用的内容
>>>>>>>>>>这是引用的内容

效果如下:

这是引用的内容

这是引用的内容

这是引用的内容

四、分割线

三个或者三个以上的 - 或者 * 都可以。
示例:

1
2
3
4
---
----
***
*****

效果如下:





五、图片

语法:

1
2
3
4
![图片alt](图片地址 ''图片title'')

图片alt就是显示在图片下面的文字,相当于对图片内容的解释。
图片title是图片的标题,当鼠标移到图片上时显示的内容。title可加可不加

示例:

1
![ChMkJlbKx8eIR_xnAAg5OT9qPFYAALH4gNaisoACDlR649.jpg](http://119.29.217.197:81/KODExplorer/index.php?user/publicLink&fid=e5a0TSbnI4S77cl4KXwaBlnXV-3Xpg9oT8u7iHRrw-0l1t8vWOCR4oJukHAKZWw9-RVOhS5KCovzXoGInV_nBTzPFHcx1qBI7evkTp-_1SyHfBxEa8bQna4eY1HFHXMmdw49iVUYQBizuV7fSKzOJ9GMY0WLJ2wGOc_2Uk29tDci5JwKgBvVoXc1eF08c2rkjUTFzP1Y1VaUaMIei2YOQi8&file_name=/ChMkJlbKx8eIR_xnAAg5OT9qPFYAALH4gNaisoACDlR649.jpg)

效果如下:

ChMkJlbKx8eIR_xnAAg5OT9qPFYAALH4gNaisoACDlR649.jpg

六、超链接

语法:

1
2
[超链接名](超链接地址 "超链接title")
title可加可不加

示例:

1
2
[简书](http://jianshu.com)
[百度](http://baidu.com)

效果如下:

简书
百度

注:Markdown本身语法不支持链接在新页面中打开,貌似简书做了处理,是可以的。别的平台可能就不行了,如果想要在新页面中打开的话可以用html语言的a标签代替。

1
2
3
4
<a href="超链接地址" target="_blank">超链接名</a>

示例
<a href="https://www.jianshu.com/u/1f5ac0cf6a8b" target="_blank">简书</a>

七、列表

  • 无序列表

    语法:
    无序列表用 - + * 任何一种都可以

示例

1
2
3
4
5
- 列表内容
+ 列表内容
* 列表内容

注意:- + * 跟内容之间都要有一个空格

效果

  • 列表内容
  • 列表内容
  • 列表内容

    • 有序列表

语法:
数字加点

1
2
3
4
5
1.列表内容
2.列表内容
3.列表内容

注意:序号跟内容之间要有空格
  1. 列表内容
  2. 列表内容
  3. 列表内容
  • 列表嵌套

    上一级和下一级之间敲三个空格即可

    • 一级无序列表内容(嵌套无序)

      • 列表嵌套

      • 列表嵌套

      • 列表嵌套

    • 一级无序列表内容(嵌套有序)

      1. 列表嵌套

      2. 列表嵌套

      3. 列表嵌套

    1. 一级有序列表内容(嵌套无序)

      • 列表嵌套

      • 列表嵌套

      • 列表嵌套

    2. 一级有序列表内容(嵌套有序)

      1. 列表嵌套

      2. 列表嵌套

      3. 列表嵌套

八、表格

语法:

1
2
3
4
5
6
7
8
9
10
11
表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容

第二行分割表头和内容。
- 有一个就行,为了对齐,多加了几个
文字默认居左
-两边加:表示文字居中
-右边加:表示文字居右
注:原生的语法两边都要用 | 包起来。此处省略

示例:

1
2
3
4
5
姓名|技能|排行
--|:--:|--:
刘备|哭|大哥
关羽|打|二哥
张飞|骂|三弟

效果

姓名 技能 排行
刘备 大哥
关羽 二哥
张飞 三弟
姓名 性别 年龄 身高 体重 爱好
小明 11 153 56 学习
小红 12 166 50 读书

九、代码

语法:
单行代码:代码之间分别用一个反引号包起来

1
`代码内容`

代码块:代码之间分别用三个反引号包起来,且两边的反引号单独占一行

1
2
3
4
5
(```)
代码...
代码...
代码...
(```)

注:为了防止转译,前后三个反引号处加了小括号,实际是没有的。这里只是用来演示,实际中去掉两边小括号即可。

示例:

单行代码

1
`this is linecode`

多行代码

1
2
3
4
5
6
(```)
function fun(){
echo "这是一句非常牛逼的代码";
}
fun();
(```)

效果如下:

单行代码

this is linecode

多行代码

1
2
3
4
function fun(){
echo "这是一句非常牛逼的代码";
}
fun();

十、流程图

简单流程

1
2
3
```mermaid
graph LR
A-->B

1
2
3
4

```mermaid
graph LR
A-->B

复杂流程

1
2
3
4
5
6
```mermaid
classDiagram
BaseClass <|-- AveryLongClass : Cool
BaseClass : size()
BaseClass : int chimp
BaseClass : int gorilla
1
2
3
4
5
6
7

```mermaid
classDiagram
BaseClass <|-- AveryLongClass : Cool
BaseClass : size()
BaseClass : int chimp
BaseClass : int gorilla

十一丶 Math函数

示例

1
2
3
开根号
```math
\sqrt{2};\sqrt[n]{3}

分数,平方

1
\frac{7x+5}{1+y^2}

下标

1
2
3
4
5
  z=z_l
```
省略号
```math
\cdots

行间公式(使用两个$包含公式可以独立一行)

1
\frac{d}{dx}e^{ax}=ae^{ax}\quad \sum_{i=1}^{n}{(X_i - \overline{X})^2}

矢量

1
\vec{a} \cdot \vec{b}=0

积分

1
\int ^2_3 x^2 {\rm d}x

累加

1
\sum \frac{1}{i^2}

累乘

1
2
\prod \frac{1}{i^2}
```

~~

注:积分函数无效,不做演示

效果

  • 开根号

    1
    \sqrt{2};\sqrt[n]{3}
  • 分数,平方

    1
    \frac{7x+5}{1+y^2}
  • 下标

    1
    2
    3
    4
    5
    z=z_l
    ```
    - **省略号**
    ```math
    \cdots
  • 行间公式(使用两个$包含公式可以独立一行)

    1
    \frac{d}{dx}e^{ax}=ae^{ax}\quad \sum_{i=1}^{n}{(X_i - \overline{X})^2}
  • 矢量

    1
    \vec{a} \cdot \vec{b}=0
  • 累加

    1
    \sum \frac{1}{i^2}
  • 累乘

    1
    \prod \frac{1}{i^2}

十二丶私密博客文章

  1. 在主题header下加入themes->/archer/layout/_partial/->base-header.ejs 添加如下代码,编译的时候会自动加入 HTML 中,
1
2
3
4
5
6
7
8
9
10
<script>
(function(){
if('{{ page.password }}'){
if (prompt('请输入查看密码') !== '{{ page.password }}'){
alert('密码不正确,请询问主编大大');
history.back();
}
}
})();
</script>
  1. 在生成文件的新页面中最顶部加上,title: 标签

keywords:

  • 私人
  • 日记
    description: 文章访问需要密码
    password: **(在你的 MD 文件中是明文)
CATALOG
  1. 1. 一、标题
  2. 2. 这是一级标题
    1. 2.1. 这是二级标题
      1. 2.1.1. 这是三级标题
        1. 2.1.1.1. 这是四级标题
          1. 2.1.1.1.1. 这是五级标题
            1. 2.1.1.1.1.1. 这是六级标题
  3. 3. 二、字体
  4. 4. 三、引用
  5. 5. 四、分割线
  6. 6. 五、图片
  7. 7. 六、超链接
  8. 8. 七、列表
  9. 9. 八、表格
  10. 10. 九、代码
  11. 11. 十、流程图
  12. 12. 十一丶 Math函数
  13. 13. 十二丶私密博客文章