关于本教程

Markdown是什么?

Markdown是一种轻量级标记语言,它以纯文本形式(易读、易写、易更改)编写文档,并最终以HTML格式发布。
Markdown也可以理解为将以MARKDOWN语法编写的语言转换成HTML内容的工具。
本博客所有内容均使用 Markdown 语法编写。

为什么要使用Markdown?

  • 易读、易写、易更改,学习成本低。
  • 兼容HTML,可以转化为HTML格式发布。
  • 纯文本内容,兼容所有的文本编辑器与字处理软件。
  • 专注你的文字内容而不是排版样式,安心写作。
  • 跨平台使用。

官方文档(本文参考资料)

1 标题

标题包含两种形式:

1)使用=-标记一级和二级标题。

语法

一级标题
=========
二级标题
---------

=-不限数量

效果

一级标题

二级标题

2)使用#,可表示1-6级标题。

语法

# 一级标题
## 二级标题
### 三级标题

如果你开心也可以在行末加入#

#### 四级标题 ####
##### 五级标题 #####

行末的#不限数量

###### 六级标题 #############

效果

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

2 列表

1) 无序列表

可使用*+-加空格作标记

语法

- 第一条
+ 第二条
* 第三条

效果

  • 第一条
  • 第二条
  • 第三条

2) 有序列表

使用任意数字加.加空格作标记

语法

你可以这样

1. 第一条
2. 第二条
3. 第三条

当然也可以这样

233. 第一条
666. 第二条
666. 第三条

数字并不影响顺序

效果

顺序

  1. 第一条
  2. 第二条
  3. 第三条

无序

  1. 第一条
  2. 第二条
  3. 第三条

如果你使用懒惰的写法,建议第一个项目最好还是从 1. 开始,因为 Markdown 未来可能会支持有序列表的 start 属性。

3 代码与引用

1) 代码

语法

代码包含两种形式:

一种适用于大段的代码

    像这样缩进4个空格或者一个制表符即可

代码区块中,一般的 Markdown 语法不会被转换,像是星号便只是星号,这表示你可以很容易地以 Markdown 语法撰写 Markdown 语法相关的文件。

另一种适合行内代码

像这样即可插入`行内代码`

效果

像这样缩进4个空格或者一个制表符即可

像这样即可插入行内代码

2) 引用

语法

在行首加入>符号即可
>这是一段引用
如果想偷懒,对于大段的文字只需在段首加即可,不需要每行均加上>符号

效果

这是一段引用

4 分隔线

语法

你可以在一行中用三个以上的星号、减号来建立一个分隔线,行内不能有其他东西。下面每种写法都可以建立分隔线:

***
***
---------------------------------------

在官方文档中说可以在上述符号中加入空格,但我在实验中发现会被转换成有序列表。

效果




5 强调

语法

*一对星号*
_一对下划线_
**两对星号**
_两对下划线_
***三对星号*
_三对下划线_

效果

一对星号
一对下划线
两对星号
两对下划线
三对星号
三对下划线

6 链接

1) 行内式

语法

[SilentSelene的小站](https://silentselene.com/)

效果

SilentSelene的小站

2) 参考式

语法

这一行放入要插入的地方

[SilentSelene的小站][1]

这一行放在文末(不会被显示)

[1]: https://silentselene.com/

效果

SilentSelene的小站

7 图片

与链接相似,在链接的语句前加入!即是图片的语句。

8 其他

反斜杠

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号。
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:

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

自动链接

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用方括号包起来, Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样,例如:

<http://example.com/>

Markdown 会转为:

<a href="http://example.com/">http://example.com/</a>

Markdown 免费编辑器

Windows 平台

Linux 平台

Mac 平台

在线编辑器

浏览器插件

高级应用(Sublime Text 2 + MarkdownEditing 教程)

标签: none

添加新评论