mobile wallpaper 1mobile wallpaper 2mobile wallpaper 3mobile wallpaper 4mobile wallpaper 5mobile wallpaper 6
972 字
3 分钟
Markdown 教程
2025-01-20

Markdown 教程#

这是一个展示如何编写 Markdown 文件的示例。本文档整合了核心语法和扩展(GMF)。

区块元素#

段落与换行#

段落#

HTML 标签:<p>

使用一个或多个空行(仅包含空格或制表符的行也被视为空行)。

代码:

这是第一段。
这是第二段。

预览:


这是第一段。

这是第二段。


换行#

HTML 标签:<br />

在行尾使用两个或多个空格即可换行。

代码:

这一行不会被切断,
但这一行会换行。
(注意行尾的两个空格)

预览:


这一行不会被切断, 但这一行会换行。


标题#

Markdown 支持 Setext 和 atx 两种标题样式。

Setext 样式#

HTML 标签:<h1>, <h2>

使用等号 (=) 表示 <h1>破折号 (-) 表示 <h2>

代码:

这是一级标题 (H1)
=============
这是二级标题 (H2)
-------------

预览:


这是一级标题 (H1)#

这是二级标题 (H2)#


atx 样式#

HTML 标签:<h1> - <h6>

在行首使用 1-6 个 # 号,对应 <h1><h6>

代码:

# 这是一级标题
## 这是二级标题
###### 这是六级标题

预览:


这是一级标题#

这是二级标题#

这是六级标题#

atx 样式标题可以选择性地在末尾“闭合”。末尾的 # 数量不需要与开头匹配。

代码:

# 这是一级标题 #
## 这是二级标题 ##
### 这是三级标题 ######

预览:


这是一级标题#

这是二级标题#

这是三级标题#


引用#

HTML 标签:<blockquote>

Markdown 使用邮件风格的 > 字符进行引用。建议在硬换行时每一行都加上 >

代码:

> 这是一段包含两个段落的引用。Lorem ipsum dolor sit amet,
> consectetuer adipiscing elit.
>
> Donec sit amet nisl.

预览:


这是一段包含两个段落的引用。Lorem ipsum dolor sit amet, consectetuer adipiscing elit.

Donec sit amet nisl.


Markdown 也允许“偷懒”,只需在每一段的第一行加上 > 即可。


引用可以嵌套(通过添加更多的 >)。

代码:

> 第一级引用
>
> > 嵌套引用
>
> 回到第一级。

预览:


第一级引用

嵌套引用

回到第一级。


引用中可以包含其他 Markdown 元素,如标题、列表和代码块。

列表#

Markdown 支持有序(数字)和无序(项目符号)列表。

无序列表#

HTML 标签:<ul>

使用 星号 (*), 加号 (+), 或 减号 (-)

代码:

* 红
* 绿
* 蓝

预览:


  • 绿

有序列表#

HTML 标签:<ol>

使用数字加点:

代码:

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

预览:


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

如果不想触发有序列表,可以转义那个点:

代码:

1986\. 这不是列表,这是一句话。

预览:


1986. 这不是列表,这是一句话。


代码块#

HTML 标签:<pre>

将每一行缩进至少 4 个空格1 个制表符

围栏代码块#

使用 ``` 包裹代码,无需缩进。

代码:

```
function test() {
console.log("Hello World");
}
```

预览:


function test() {
console.log("Hello World");
}

语法高亮#

在围栏代码块后面加上语言名称即可开启高亮。

def hello
puts "Hello"
end

水平分割线#

HTML 标签:<hr />

在一行中使用三个或多个 减号 (-), 星号 (*), 或 下划线 (_)


表格#

HTML 标签:<table>

使用 管道符 (|) 分隔列,破折号 (-) 分隔表头,冒号 (:) 控制对齐。

代码:

| 左对齐 | 居中 | 右对齐 |
|:---|:---:|---:|
| A | B | C |

预览:

左对齐居中右对齐
ABC

行内元素#

链接#

HTML 标签:<a>

行内式#

[链接文字](URL "标题") 示例:百度

参考式#

[id]: URL "标题" [链接文字][id]

强调#

HTML 标签:<em> (斜体), <strong> (粗体)

  • *斜体*_斜体_
  • **粗体**__粗体__

代码#

HTML 标签:<code>

使用**反引号 ()** 包裹。 示例:print(“Hello”)`

图像#

HTML 标签:<img />

语法:![Alt 文字](图片链接 "标题")


杂项#

自动链接#

使用尖括号:<https://example.com>

反斜杠转义#

Markdown 使用反斜杠来显示原有的特殊字符(如 \* 显示为星号)。

行内 HTML#

Markdown 支持直接书写 HTML。注意,在块级 HTML 标签内,Markdown 语法通常不生效(即不会被解析),但在行内元素中可能会被解析。


译注:以上内容为对原 Markdown 教程文档的翻译与精简。

分享

如果这篇文章对你有帮助,欢迎分享给更多人!

Markdown 教程
https://github.com/emn178/markdown
作者
emn178
发布于
2025-01-20
许可协议
Unlicensed

部分信息可能已经过时

封面
Sample Song
Sample Artist
封面
Sample Song
Sample Artist
0:00 / 0:00