Markdown 渲染与图片验收

本页用途

这是一篇真实参与构建的语法样例。修改解析器后，从首页项目板块打开本页，检查嵌套层级、表格、代码、引用和图片。自动化验证位于 scripts/site.test.js。

嵌套列表与任务清单

1. 准备一篇文章。
   • 使用一个顶级标题。
   • 加入关联阅读。
     • 相对路径指向另一篇 Markdown。
2. 执行构建。
   • 解析嵌套列表。
   • 保持代码字面量。
   • 人工检查新增外链的有效性。

引用、强调与代码字面量

引用可以包含多个结构。

• 重点保留强调。
• 行内代码 user_name 不应变成斜体。

第二层引用仍有自己的层级。

斜体、粗体、删除线 与 [label](target) 都应按各自语义展示。

表格、换行与竖线

代码围栏内的 Markdown

# 这是示例，不应成为本页目录

```js
const text = '**字面量**';
```

![[这不是需要复制的图片.png]]

本地图片

下图复用仓库已有的线程池笔记图片，使用包含空格的相对路径。构建只复制实际引用、位于 content/ 内的图片。

原笔记中的 ![[Pasted image 20251114125656.png]] 也受支持，按当前文章目录解析。可用 ![[文件名|替代文字]] 提供描述；数字尺寸扩展、跨目录按 basename 自动搜索不在本轮支持范围。

安全边界与暂不支持的语法

普通 HTML 标签会作为文字显示：<script>alert('example')</script>。带属性的 HTML、iframe 和脚本不会执行；代码块里的 HTML 也始终按代码展示。表格中的无属性 <br> 是显式支持的例外。

Mermaid 代码块目前保留为可读源码；数学公式、脚注和任意原始 HTML 渲染尚未接入。站内相对 Markdown 链接及图片路径已支持，但这不等于完整兼容所有笔记软件语法。

构建诊断

npm run site:build
npm run site:build -- --strict

普通构建在 site/dist/build-report.json 记录缺失文章与图片；缺失本地图在页面上显示文字提示，不制造裂图。严格构建遇到这类问题会失败，并保留上一次输出。远程图片保留原 URL，不自动下载，也不验证远程可用性。