markdown 说明

用markdown写博客这么久了，确实觉得很便利，但有时候还是会把语法忘掉，今天就写篇博文记录一下。

markdown 简介

markdown 是一种轻量级标记语言，使用易读易写的纯文本格式，最终可以生成html文档；所以它可以让你专注于写作，而不会为了刻意的排版而丢失灵感，它还支持直接插入html文本。

markdown 只是规定了一种语法，具体效果视所使用的markdown编辑器或者转换器而决定。下面记录一下基本的markdown语法。

为了让文章看起来不乱，对于示例使用代码块展示，该示例效果使用引用表示

标题

使用 # 来实现标题，几个 # 对应 html 几级标题

### 三级标题

会产生下面的效果

三级标题

段落

默认一段话就是一个段落，段落与段落中间用空行隔开。但是插入多个的空行会被视为1个空行，所以要插入空行的话，需要使用 html <br/> 。（这就是一个段落啊，你看看html源代码是不是一个 <p></p>）

超链接

[这就是一个超链接](/)

它会转换为 <a href='/'>这就是一个超链接</a>

并显示为

这就是一个超链接

图片

![name](/assets/images/avatar.jpg)

它被转换为 <img alt="name" src="/assets/images/avatar.jpg"/>

并显示为

强调

使用 *em* 或者 _em_进行强调，共有3个级别。

• 斜体

  *em*
  

  转换成这样

  em

• 加粗

  **em**
  

  转换成这样

  em

• 加粗斜体

  ***em***

  转换成这样

  em

代码

• 行内代码用反引号

  这里要引用一下 `print`
  

  这里要引用一下 print

• 代码块用 tab 缩进

      # include <stdio.h>
      int main(void)
      {
          print("hello world!");
          return 0;
      }
  

  显示如下

  # include <stdio.h>
  
  int main(void)
  {
     printf("hello world!");
     return 0;
  }
  

  或者使用3个反引号

  ``` C
  # include <stdio.h>
  
  int main(void)
  {
      printf("hello world!");
      return 0;
  }
  ```
  

  这么做的好处很明显：1. 在缩进层级比较深的时候很清晰；2. 可以指定语法高亮

引用区块

那就要用到这个符号 > 了。

>这是一个引用

这是一个引用

>first line
>second line
>third line

这是一个引用区块

two

three

markdown支持多级引用

>first
>>second
>>>third

first

second

third

水平分割线

在一行里面用3个或以上 星号(*)、短横线(-) 产生水平线，中间可以有空格，但这一行不能有其他字符

---
***
- - - -

断行

markdown 里面其实有一个在行尾插入2个空行强制断行，但个人觉得这样做并不好用

这只是一个大概的语法，详细的语法请看这里。