0%

markdown语法快速入门

Posted on Edited on In

markdown 语法快速入门

标题

标题的语法有两种形式，Setext 和 Atx。

  1. Setext，用底线的形式，利用=（最高阶标题）和-（第二阶标题）：

最高阶标题，渲染成 HTML 中的h1标签

最高阶标题
=========

第二阶标题，渲染成 HTML 中的h2标签

第二阶标题
----------
  1. Atx，用行首的#字符标识标题的阶数，1-6 个#字符标识第 1-第 6 阶标题

第一阶，渲染成 HTML 中的h1标签

# 第一阶

第二阶，渲染成 HTML 中的h2标签

## 第二阶

第三阶，渲染成 HTML 中的h3标签

### 第三阶

第四到六阶依此类推

段落

一个段落由一个以上的连接的行句组成，而一个以上的空行则会划分出不同的段落，一般的段落不需要用空白或者换行缩进。

空行的定义时显示上看起来像是空行，就会被视为空行，例如一行只有空白或者 tab，那这行就会被视为空行。

段落并没有特殊的标记符号，需要注意的只有换行。换行有两种方式：

  1. 用一个以上的空白行来实现，这种方式的效果是每个段落被渲染在<p></p>标签中。
  2. 在段落结尾按入两个空格，然后回车，这种方式的效果是在段落结尾插入了<br />标签。

区块

区块引用使用 email 形式的>叫括号

这是一个区块

> 这是一个区块

区块可以嵌套，区块内也可以包含其他 markdown 语法，例如标题、列表、代码区块等

这是一个引用区块

区块里嵌套了一个区块

  • 区块里的列表 1
  • 区块里的列表 2

区块里嵌套代码块：

console.log('我是区块里的代码块')

字体

使用*和_来标记，包括斜体和粗体两种。

这是斜体文本，这是斜体文本位于段落中间

这是*斜体文本*，这是*斜体文本*位于段落中间

这是 斜体文本

这是 _斜体文本_

这是 斜体文本 位于段落中间

这是 _斜体文本_ 位于段落中间 (如果斜体文本在段落中，"_"符号前后需要有空格，前或后至少一个位置有空格，但是空格会被渲染出来，所以斜体还是用"*"表示比较好)

这是粗体文本

这是**粗体文本**

这是粗体文本

这是__粗体文本__

这是粗斜体文本

这是***粗斜体文本***

这是粗斜体文本

这是___粗斜体文本___

列表

  1. 无序列表，使用*、+、-来标识
  • Red
  • Green
* Red
* Green
  • Red
  • Green
+ Red
+ Green
  • Red
  • Green
- Red
- Green

列表之间可以插入段落，每个段落需要缩进 4 个空格或者 1 个制表符

  • 这是列表第一项

    这是一个段落

    这是又一个段落

  • 这是列表第二项

这是写法：

* 这是列表第一项

  这是一个段落

  这是又一个段落

* 这是列表第二项

列表中可以插入引用，>符号需要缩进

  • 这是列表第一项

    这是一个引用

这是写法：

* 这是列表第一项

  > 这是一个引用

列表中插入代码块，代码块需要缩进两次

  • 这是列表第一项

    console.log('列表中的代码块，缩进了8个空格')

这是写法：

* 这是列表第一项

        console.log('列表中的代码块，缩进了8个空格')
  1. 有序列表，使用数字加英文句点标识
  1. Bird
  2. Mchale
  3. Parish
1. Bird
2. Mchale
3. Parish

分隔线

使用三个以上的*，-，_来建立一个分隔线，行内不能有其他内容

隔开

隔开

链接

链接语法分为：行内和参考两种形式

  1. 行内

这是一个链接去百度

这是一个链接去[百度](https://www.baidu.com)

这是一个链接去百度，加上了 title 属性。

这是一个链接去[百度](https://www.baidu.com/ "百度")，加上了title属性。
  1. 参考

学习 markdown，我参考了两篇文章：快速入门和详细介绍

学习markdown，我参考了两篇文章：[快速入门][1]和[详细介绍][2]

[1]: https://www.appinn.com/markdown/basic.html
[2]: https://www.appinn.com/markdown/ "这里是链接的title属性"

参考形式的链接可以定义一次，而且可以集中定义在文本的某处，方便查看，定义好的链接可以多处使用。

http://www.google.com

代码

  1. 在段落中插入代码段，使用”`”反引号来标识

在 html 中，我们用<h1></h1>标签来显示标题；在 js 中我们使用console.log()来打印日志。

在html中，我们用`<h1></h1>`标签来显示标题；在js中我们使用`console.log()`来打印日志。
  1. 建立一个格式化好的代码块，每行缩进 4 个空格或者一个 tab:
    function print() {
    console.log('hello, hexo')
}

图片

图片的语法和链接很像, 也分为行内和参考两种形式

  1. 行内

天空

![天空](http://img.52z.com/upload/news/image/20180621/20180621055734_59936.jpg "蓝天碧水")
  1. 参考

天空

![天空][id]

[id]: http://img.52z.com/upload/news/image/20180621/20180621055734_59936.jpg "蓝天碧水"

我放在阿里云上的图片

反斜杠转义

markdown 中有不少语法是使用一些符号来实现的，当我们需要显示这些符号本身时，就需要反斜杠来帮忙。

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号