Markdown 复杂排版与发布兼容性测试

这是一篇用于测试 Obsidian → 发布插件 → WordPress 的复杂 Markdown 文章。它同时包含常用 Markdown 格式和扩展语法，适合检查转换过程中的层级、缩进、转义、渲染与排版问题测试。

本文没有添加插件专用的发布元数据。任务列表、表格、脚注、公式、Mermaid 和 HTML 等内容的显示效果取决于插件、WordPress 编辑器及主题配置；如果显示为原始文本，也可以据此判断当前流程支持到哪里。

一、正文、段落与混合字符

这是普通正文的第一段。中文内容与 English words、数字 2026、版本号 v2.3.1 混合出现。标点测试包括：中文逗号，中文句号。中文问号？中文感叹号！中文冒号：中文分号；以及“中文双引号”和‘中文单引号’。

这是第二段正文，用于测试独立段落。括号测试包括（中文括号）、(English parentheses)、[方括号]、{花括号}，以及特殊字符 &、<、>。这些字符应作为正文显示。

下面这句话测试多种强调格式：粗体内容、斜体内容、粗斜体内容、删除线内容，以及行内代码 post_status = "draft"。删除线属于扩展语法。

这是使用行尾两个空格实现的第一行。
这是同一段落中的第二行，检查是否发生换行。

这是使用反斜杠实现的第一行。
这是同一段落中的第二行，检查插件如何转换这种换行写法。

1.1 长段落与自动折行

这一段刻意写得较长，用于观察桌面和移动端页面的正文宽度、自动折行与行间距。写作时，我们经常需要在同一段落中同时描述背景、步骤、结果和注意事项；发布后，文本应根据页面宽度自动换行。可以缩小浏览器窗口检查中英文混排是否自然，也可以观察逗号、句号、括号和行内代码之间的间距。这里还包含一段连续字符串 abcdefghijklmnopqrstuvwxyz0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ，用于检查长词是否造成页面横向溢出。

1.2 标题层级与重复标题

四级标题：标题中的 加粗 与 inline-code

四级标题下面的正文，用于检查标题内部格式。

五级标题：中文 / English / 123

五级标题下面的正文，用于检查混合字符。

六级标题：最深层级

六级标题下面的正文，用于检查最深标题的字号和间距。

重复的小节标题

这是第一次出现相同小节标题。

重复的小节标题

这是第二次出现相同小节标题。如果主题或插件自动生成目录，可以检查这两个标题能否分别定位。

二、链接、图片与文字转义

2.1 链接的不同写法

• 普通链接：WordPress 官网。
• 带标题的链接：Obsidian 官网。
• 引用式链接：访问 WordPress 文档。
• 自动链接：https://example.com/。
• 带查询参数的链接：示例查询链接。
• 将行内代码放在链接文字里：查看 example.com。

以上链接主要用于测试格式，example.com 是示例地址。

2.2 远程图片、替代文本与图注

下面是一张远程 SVG 测试图片。显示效果取决于网络访问和发布流程对远程图片的处理。

图 1：普通正文形式的图注，用于检查图片与后续段落的间距。

2.3 转义字符

以下符号应作为普通字符出现：*星号*、_下划线_、#井号、[方括号]、`反引号`、1. 这不是有序列表。

这一行以转义井号开头：

# 这是一段正文，不应变成标题。

下面的行内代码包含反引号，使用双反引号包裹：代码中包含 `反引号` 的内容。

三、多层列表与复杂缩进

3.1 三层无序列表

• 文章准备
  • 内容整理
    • 确定文章标题。
    • 检查正文段落。
    • 补充 重点内容 与 代码片段。
  • 格式检查
    • 标题层级。
    • 链接与图片。
• 发布检查
  • WordPress 编辑器
    • 内容是否完整。
    • 列表是否被意外拆开。
  • 博客前台
    • 桌面端排版。
    • 移动端排版。

3.2 有序与无序混合嵌套

1. 准备测试文章。
   • 将文件放入 Obsidian 仓库。
   • 打开阅读视图。
   • 记录当前插件配置。
2. 检查文章结构。
   1. 检查标题。
      • 确认层级连续。
      • 确认相同标题可以共存。
   2. 检查正文。
      • 确认中文显示正常。
      • 确认段落间距自然。
3. 执行发布。
   • 打开发布后的页面。
   • 对照原文逐项检查。

3.3 列表项目中的多个段落、引用和代码

1. 一个包含多个段落的列表项目。

   这是第一项内部的第二段正文。它应保持在当前列表项内部，而不是变成列表外的段落。

   这是第一项内部的引用块。

   引用中的第二段也应保持缩进。

   const post = {
       title: "复杂 Markdown 测试",
       status: "draft"
   };
   console.log(post.title);
   

2. 第二个列表项目。

   这段文字应归属于第二项，且第二项编号应与上一项连续。

   • 第二项中的无序子列表。
   • 另一个子项目，含有 示例链接。

3. 第三个列表项目。

   用于确认引用和代码块没有中断外层列表编号。

3.4 非 1 起始的有序列表

7. 这是从编号 7 开始的列表。
8. 下一项应显示为 8。
9. 再下一项应显示为 9。

3.5 任务列表（扩展语法）

• [x] 已检查普通正文。
• [x] 已准备标题与列表测试内容。
• [ ] 等待检查 WordPress 前台显示。
• [ ] 等待确认扩展语法支持情况。
  • [x] 已添加脚注示例。
  • [ ] 尚未核对脚注跳转。

四、引用、嵌套引用与引用内列表

这是一段普通引用。

引用中的第二段包含 粗体、斜体 和 inline code。

这是一层嵌套引用。

这是第二层嵌套引用。

引用内还可以放入列表：

1. 检查引用的左侧边框。
2. 检查背景颜色与缩进。
3. 检查嵌套层级。

这是引用中的代码块。
第二行内容应保留换行。

这是引用结束后的普通正文，应恢复正常的段落样式。

五、多语言代码块与特殊字符

5.1 JavaScript：中文、模板字符串与嵌套对象

const article = {
    title: "Markdown 复杂测试",
    tags: ["Obsidian", "WordPress", "排版测试"],
    options: {
        draft: true,
        preserveFormatting: true
    }
};

function renderSummary({ title, tags }) {
    return `${title}：${tags.join(" / ")}`;
}

console.log(renderSummary(article));

5.2 Python：空行、缩进与中文注释

from decimal import Decimal


def calculate_total(items):
    """使用十进制数计算示例金额。"""
    total = Decimal("0.00")

    for item in items:
        total += Decimal(item["price"]) * item["quantity"]

    return total


items = [
    {"name": "笔记本", "price": "12.50", "quantity": 2},
    {"name": "钢笔", "price": "8.80", "quantity": 1},
]

print(f"总金额：{calculate_total(items):.2f}")

5.3 JSON：布尔值、数组与转义

{
  "title": "复杂 Markdown 测试",
  "published": false,
  "categories": ["测试", "写作"],
  "description": "包含引号：\"示例\"，以及换行：\n第二行",
  "metadata": {
    "author": "测试作者",
    "version": 1
  }
}

5.4 HTML：标签必须显示为代码

<section class="demo" data-mode="test">
    <h2>这是代码中的标题</h2>
    <p>特殊字符：&amp; &lt; &gt; &quot;</p>
    <a href="https://example.com/?a=1&amp;b=2">示例链接</a>
</section>

5.5 SQL：注释与多行查询

-- 仅用于代码排版测试的查询示例
SELECT
    category,
    COUNT(*) AS article_count
FROM articles
WHERE status = 'draft'
GROUP BY category
ORDER BY article_count DESC;

5.6 四反引号代码围栏：展示 Markdown 源码

下面的外层围栏使用四个反引号，内部的三个反引号应完整显示。

## 一个 Markdown 示例标题

- **加粗的列表项目**
- 普通列表项目

```javascript
console.log("内部代码围栏应完整显示");
```

5.7 波浪号围栏

这是使用三个波浪号包裹的代码块。
请检查它是否与反引号代码块具有一致的显示效果。

5.8 无语言标记的代码块与长行

第一行：保留空格与换行。
    第二行：前面有四个空格。
第三行：<tag> & "quotes" *asterisks* _underscores_
https://example.com/a/very/long/path/for/testing/horizontal/scrolling/in/code/blocks?source=obsidian&destination=wordpress&mode=markdown-compatibility-test

六、复杂表格（扩展语法）

6.1 对齐、链接与行内代码

6.2 长内容与单元格换行

七、脚注（扩展语法）

普通正文中可以插入脚注标记，例如这一句包含第一条脚注。[^first]

同一个脚注也可以再次引用。[^first] 这里还有一条包含多段内容的脚注。^multi

请检查正文中的脚注标记是否能跳转到文末，以及脚注是否提供返回正文的链接。

八、数学公式（扩展语法）

8.1 行内公式

这是一个行内公式：$a^2 + b^2 = c^2$。请观察公式是否与前后正文保持合适的基线和间距。

8.2 独立公式块

$$
S_n = \sum_{i=1}^{n} i = \frac{n(n+1)}{2}
$$

8.3 多行公式

$$
\begin{aligned}
f(x) &= x^2 + 2x + 1 \\
&= (x + 1)^2
\end{aligned}
$$

如果公式以 $ 和反斜杠原样显示，说明当前发布流程没有完成相应的数学渲染。

九、Mermaid 流程图（扩展语法）

flowchart TD
    A[在 Obsidian 中编写文章] --> B[检查阅读视图]
    B --> C[通过插件发布]
    C --> D[打开 WordPress 前台]
    D --> E{排版是否完整}
    E -->|是| F[记录测试通过]
    E -->|否| G[记录不兼容格式]
    G --> H[调整插件或文章格式]
    H --> C

这个代码块可用于判断插件或博客页面是否支持 Mermaid 渲染。没有相应支持时，可能显示为代码块。

十、HTML 折叠区与混合内容

下面使用原始 HTML 创建折叠区，测试发布流程是否保留这些标签。

status = "draft"
message = "HTML 折叠区测试"

这是折叠区域之后的普通 Markdown 正文，包含 加粗文字，用于检查 HTML 区块结束后是否恢复 Markdown 解析。

十一、Obsidian 专用语法对照

下面的内容用于额外检查 Obsidian 专用语法。它们可能需要插件转换才能在 WordPress 上获得对应效果。

11.1 高亮与内部链接

这是 ==Obsidian 高亮文字== 的测试。

这是一个内部链接：[[Markdown发布测试文章]]。

这是带显示名称的内部链接：[[Markdown发布测试文章|查看基础测试文章]]。

内部链接需要仓库中存在对应笔记才有目标；发布后能否成为博客链接取决于插件配置。

11.2 Callout 提示块

[!NOTE] 测试提示
这是 Obsidian Callout 示例，包含 重点文字 和 inline code。

• 第一条说明。
• 第二条说明。

11.3 Obsidian 注释

下面这句包含一段 Obsidian 注释：正文开始。正文结束。

十二、分隔线与替代标题语法

以下依次测试三种分隔线：

第一条分隔线之后的正文。

第二条分隔线之后的正文。

第三条分隔线之后的正文。

使用下划线形式的二级标题

这段正文位于 Setext 风格的二级标题下，用于测试另一种标题写法。

十三、发布结果记录

下面的表格可以在测试后填写。所有状态均为待检查，不代表已经验证通过。

这篇文章的用途是提供一份复杂排版样本。发布完成后，可以记录每种语法的实际表现，再确定正式博客文章适合采用哪些格式。

[^first]: 这是第一条脚注，包含 加粗内容 和 示例链接。

这是多段脚注的第二段，包含行内代码 `footnote_example`。

- 脚注中的列表项目一。
- 脚注中的列表项目二。