写文建站文章的 Markdown 与嵌入写法

Markdown 语法指南

本指南演示 EdgePress 文章支持的 Markdown 功能。源文件保持易读，渲染后的 HTML 会先经过净化再显示在页面中。

标题与段落

在标题前添加井号即可设置层级。空行会开始一个新段落。

Heading level three

Heading level four

Heading level five

Heading level six

Setext heading level two

行尾添加反斜线可以产生硬换行。
这一行仍属于同一个段落。

分隔线

常见的三种写法都会生成水平分隔线：

---

---

---

强调与代码

可以使用 斜体、粗体 和 删除线。行内代码写作 npm run build。

const greeting = "Hello, Markdown.";

也可以用波浪线围住代码：

This block uses a tilde fence.

每行缩进四个空格也会生成代码块：

const indented = "four spaces";

用 ` 可以在代码片段中显示一个反引号。

在代码片段中写 \*，可以展示转义后的星号。字符引用 < 和 & 会显示为普通文本。

链接与图片

行内链接可以指向项目页面，引用式链接则指向关于页面。

GFM 会将裸网址自动转换为链接：https://www.markdownguide.org/ 。尖括号网址、www 域名和电子邮箱地址也会自动识别：https://commonmark.org www.example.com team@example.com。

展示 Markdown 文档如何生成静态页面的示意图

以图片语法链接 MP4 文件时，会生成视频播放器：

![户外录影](https://media.example.org/field-recording.mp4 "Wind test")

列表与引用

• 列表项目中也可以使用 格式。

  1. 在无序列表中嵌套有序项目。
  2. 再添加一个嵌套项目。

• ✓ 已完成任务会带有无障碍状态标签。

• □ 未完成任务会使用另一种状态标签。

区块引用中可以放入列表：

• 第一条引用项目。
• 第二条引用项目。

区块引用也可以继续嵌套。

这是内层引用。

表格与安全 HTML

Syntax	Rendered form
# Heading	A heading
**text**	Strong emphasis

需要时可以使用 Ctrl 这样的语义化行内 HTML。净化器会移除 等主动内容。