Loading

Markdown基本语法

目录

概述

  Markdown是John Gruber于2004年创建的轻量级标记语言，它允许人们使用易读易写的纯文本格式来编写文档，然后转换成为HTML和许多其他格式的文件，比如将Markdown转换成PDF，HTML。Markdown通常用于格式化README文件，用于在线论坛中撰写邮件等，比如GitHub上的README文档。下面来介绍一下常用的Markdown语法。

语法

1. 标题

Markdown有两种语法来写标题

  • 用特定数量的 # 来实现：
# 标题一
## 标题二
### 标题三
  • 用 =（最高阶标题）和 -（第二阶标题）
标题一
===========
标题二
-----------

2. 列表

列表分为有序列表和无序列表，顾名思义就是分为有序号和无序号两种列表

1. 无序列表

无序列表使用的时候，在文字前面加上 - 或 * 或 +

* 无序列表
* 无序列表
* 无序列表

预览结果：

  • 无序列表一
  • 无序列表二
  • 无序列表三

2. 有序列表

有序列表使用的时候，在文字前面加上 1. 2. 3.

1. 有序列表一
2. 有序列表二
3. 有序列表三

预览结果：

  1. 有序列表一
  2. 有序列表二
  3. 有序列表三

3. 引用

在文字前面加上 > 即可

> 博观而约取，厚积而薄发

预览结果：

博观而约取，厚积而薄发

使用嵌套引用

> 博观而约取，厚积而薄发
>> 博观而约取，厚积而薄发

预览结果：

博观而约取，厚积而薄发

博观而约取，厚积而薄发

这里可能看的不是很明显

使用嵌套列表

> * 嵌套列表一
> * 嵌套列表二
> * 嵌套列表三
>     * 嵌套子列表一
>     * 嵌套子列表二

预览结果：

  • 嵌套列表一
  • 嵌套列表二
  • 嵌套列表三
    • 嵌套子列表一
    • 嵌套子列表二

注意：无序子列表中与上面的 * 要有四个空格，也就是说距离前面的 > 要有五个空格（加上 * 和 > 之间的空格）

4. 代码区块

在文章中添加代码，如果代码只有一行，可以用 ` 字符将代码包括；如果代码多行，可以用 ``` 将代码包括，比如:

```C
#include <stdio.h>
#include <stdlib.h>

int main(int argc, char const *argv[])
{
    printf("hello world\n");
    return 0;
}
```

预览结果是这样的

#include <stdio.h>
#include <stdlib.h>

int main(int argc, char const *argv[])
{
    printf("hello world\n");
    return 0;
}

注意：第一个``` 后面跟的是语言类型，这里的例子是C语言，所以上面写着C

5. 斜体和粗体

  • 斜体

用一个 * 或 _ 将文字包括，下面使用的星号：

*斜体*

斜体

  • 粗体

用两个 * 或 _ 将文字包括，下面使用的星号：

**粗体**

预览结果：

粗体

6. 删除线

使用两个 ~ 将文字包括，比如：

~~删除线~~

预览结果：

删除线

7. 空格

  • 半角空格（英文）

&nbsp;

  • 全角空格（中文）

&emsp;

8. 分割线

分割线有三种，字符之间可以有一个空格相隔

  • 三个或更多个星号组合
  • 三个或更多个减号组合
  • 三个或多个下划线组合

星号：
*************

减号：
-------------

下划线：
_____________

或：

星号和空格相隔：
* * * * * * * * * * 

减号和空格相隔：
- - - - - - - - - - 

下划线和空格相隔：
_ _ _ _ _ _ _ _ _ _

预览结果是这样的：

星号：

减号：

下划线：

或：

星号和空格相隔：

减号和空格相隔：

下划线和空格相隔：

[]()

注意：其中中括号是文字，小括号是链接地址

![]()

注意：其中小括号是图片的链接地址

结语

  上面这些是Markdown的基本语法，还有一些高级的语法比如表格，标签分类，待办事宜，流程图等等。暂时先写着这些，以后用得上更高级的语法的时候在补上。

posted @ 2018-02-02 11:00  洛九川  阅读(256)  评论(0)    收藏  举报