markdown语法

最新推荐文章于 2025-06-06 20:33:50 发布

原创最新推荐文章于 2025-06-06 20:33:50 发布 · 1k 阅读

8 ·

CC 4.0 BY-SA版权

文章标签：

#markdown语法

markdown 专栏收录该内容

1 篇文章

订阅专栏

MarkDown语法

因为新博客：bks.me需要使用到markdown，便想学习一下

HTML 是一种发布的格式，Markdown 是一种书写的格式

1. 段落，标题，区块代码

Markdown 支持两种标题的语法，Setext 和 atx 形式
Setext 形式是用底线的形式，利用 = （最高阶标题）和 - （第二阶标题）
Atx 形式在行首插入 1 到 6 个 # ，对应到标题 1 到 6 阶。

A First Level Header
====================
A Second Level Header
---------------------

##### Header 5

- 区块引用则使用 email 形式的 ‘>‘ 角括号(允许嵌套)
- 那会看起来像是你自己先断好行，然后在每行的最前面加上 > ：

> This is a blockquote.
>
> This is the second paragraph in the blockquote.
>
> ## This is an H2 in a blockquote

2. 列表

无序列表使用星号*、加号+和减号-来做为列表的项目标记，这些符号是都可以使用的

* Candy.
* Gum.
* Booze.

有序的列表则是使用一般的数字接着一个英文句点作为项目标记

1. Red
2. Green
3. Blue

3. 链接

This is an [example link](http://example.com/).

有提示的链接

This is an [example link](http://example.com/ "With a Title").

参考形式的链接让你可以为链接定一个名称，之后你可以在文件的其他地方定义该链接的内容：

I get 10 times more traffic from [Google][1] than from
[Yahoo][2] or [MSN][3].

[1]: http://google.com/ "Google"
[2]: http://search.yahoo.com/ "Yahoo Search"
[3]: http://search.msn.com/ "MSN Search"

4. 图片

图片的语法和链接很像。
行内形式（title 是选择性的）：

![alt text](/path/to/img.jpg "Title")

参考形式：

![alt text][id]

[id]: /path/to/img.jpg "Title"

5.代码

要在 Markdown 中建立代码区块很简单，只要简单地缩进 4 个空格或是 1 个制表符就可以，例如，下面的输入：

这是一个普通段落：

    这是一个代码区块。

在代码区块里面， & 、 < 和 > 会自动转成 HTML 实体，这样的方式让你非常容易使用 Markdown 插入范例用的 HTML 原始码，只需要复制贴上，再加上缩进就可以了，剩下的 Markdown 都会帮你处理，例如：

6. 分割线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线：

* * *

***

*****

- - -

---------------------------------------

7.强调
Markdown 使用星号（*）和底线（_）作为标记强调字词的符号，被 * 或 _ 包围的字词会被转成用 标签包围，用两个 * 或 _ 包起来的话，则会被转成，例如：

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__