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

Markdown 教程#

一个展示如何编写 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 个井号 (#),对应标题级别 1-6。

代码:

# 这是 H1
## 这是 H2
###### 这是 H6

预览:


这是 H1#

这是 H2#

这是 H6#

引用#

HTML 标签:<blockquote>

在每一行开头使用 >

Code:

> 这是引用。
> 这是引用的第二行。
>
> 这是引用的第二段。

预览:


这是引用。 这是引用的第二行。

这是引用的第二段。


嵌套#

引用可以嵌套。

代码:

> 这是第一层引用。
>
> > 这是嵌套的引用。
>
> 回到第一层。

预览:


这是第一层引用。

这是嵌套的引用。

回到第一层。


列表#

Markdown 支持有序列表和无序列表。

无序列表#

HTML 标签:<ul>

使用 星号 (*)、加号 (+) 或破折号 (-) 作为列表标记。

代码:

* 红色
* 绿色
* 蓝色

预览:


  • 红色
  • 绿色
  • 蓝色

有序列表#

HTML 标签:<ol>

使用数字后跟句点

代码:

1. 鸟
2. 麦克海尔
3. 帕里什

预览:


  1. 麦克海尔
  2. 帕里什

代码块#

HTML 标签:<pre><code>

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

代码:

这是一个普通段落:
这是一个代码块。

预览:


这是一个普通段落:

这是一个代码块。

分隔线#

HTML 标签:<hr />

在一行中使用三个或更多破折号、星号或下划线

代码:

***
---
___

预览:




表格#

使用 竖线 (|)破折号 (-) 创建表格。

代码:

| 表头 1 | 表头 2 |
| ------ | ------ |
| 单元格 1 | 单元格 2 |
| 单元格 3 | 单元格 4 |

预览:


表头 1表头 2
单元格 1单元格 2
单元格 3单元格 4

对齐#

你可以通过在分隔线中添加冒号 (:) 来指定列的对齐方式。

代码:

| 左对齐 | 居中对齐 | 右对齐 |
| :---- | :----: | ----: |
| 单元格 1 | 单元格 2 | 单元格 3 |
| 单元格 4 | 单元格 5 | 单元格 6 |

预览:


左对齐居中对齐右对齐
单元格 1单元格 2单元格 3
单元格 4单元格 5单元格 6

行内元素#

链接#

Markdown 支持两种链接样式:内联和引用。

内联#

代码:

这是 [示例](http://example.com/ "标题") 内联链接。
[这个链接](http://example.net/) 没有标题属性。

预览:


这是 示例 内联链接。

这个链接 没有标题属性。


引用#

代码:

这是 [示例][id] 引用样式链接。
[id]: http://example.com/ "可选标题"

预览:


这是 示例 引用样式链接。


强调#

Markdown 将星号 (*)下划线 (_) 视为强调指示符。

斜体#

HTML 标签:<em>

一个 * 或 _ 包裹。

代码:

*单星号*
_单下划线_

预览:


单星号

单下划线


粗体#

HTML 标签:<strong>

两个 * 或 _ 包裹。

代码:

**双星号**
__双下划线__

预览:


双星号

双下划线


代码#

HTML 标签:<code>

反引号 (`) 包裹。

代码:

使用 `printf()` 函数。

预览:


使用 printf() 函数。


图片#

Markdown 使用类似链接语法的图片语法,允许两种样式:内联和引用。

内联#

代码:

![替代文本](/path/to/img.jpg)
![替代文本](/path/to/img.jpg "可选标题")

引用#

代码:

![替代文本][id]
[id]: /path/to/img.jpg "可选标题"

删除线#

HTML 标签:<del>

两个波浪号 (~~) 包裹。

代码:

~~删除文本~~

预览:


删除文本


其他#

自动链接#

Markdown 支持自动创建 URL 和电子邮件地址链接的快捷样式。

代码:

<http://example.com/>
<address@example.com>

预览:


http://example.com/

address@example.com


反斜杠转义#

Markdown 允许你使用反斜杠转义来生成字面字符。

代码:

\*字面星号\*

预览:


*字面星号*


内联 HTML#

你可以在 Markdown 中使用原始 HTML。

代码:

<div>这是一个 div。</div>

预览:


这是一个 div。

分享

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

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

部分信息可能已经过时

目录