用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个空行强制断行,但个人觉得这样做并不好用
这只是一个大概的语法,详细的语法请看这里。