fix: print PDF from actual editor theme CSS and shared Markdown rendering

docs/development/Export开发说明.md

@@ -167,3 +167,14 @@ PDF 使用导出按钮点击时的主题配色快照，支持六种内置/社区
 PDF 取消导出源/产物大小限制、Mermaid 数量和像素预算、请求资源数量和字节预算、Vault 图片大小/累计预算、MathText 长度/深度预算、函数图数量/表达式数量及 AST 预算。HTML/DOCX、在线预览仍使用原有限制；有效图片、Vault 路径、表达式语法校验和数值求解退出条件仍生效。无限制指移除应用导出配额，实际文件规模仍受浏览器、解析器和可用内存约束。
 
 关闭窗口仅结束 UI 生命周期，导出流程继续；主动取消仍取消提交中的后台任务。回归测试见 `ExportDialog.spec.ts`、`exportService.spec.ts`、`test_pdf_theme_resources.py`。
+
+
+### PDF 实际主题样式修正（2026-09-07）
+
+七色调色板加 ReportLab 固定排版不能复现笔记主题。应用界面的 PDF 导出现在提交 `print_html`：复用 Markdown 渲染器、KaTeX、Shiki、编辑器 DOM 容器、主题 CSS、CSS 变量、标题偏好和字体资源，由 Chromium 打印为可选择文本的 PDF。保留背景纹理、伪元素、边框、阴影和语义样式；打印规则只处理页面尺寸、滚动容器、分页、图表缩放和交互按钮。提示块采用编辑器的 blockquote 结构以匹配主题选择器。KaTeX 内部 SVG 不应用图表缩放规则。
+
+`POST /api/exports/preview-resources` 根据同一 Markdown 快照准备 Vault 图片和函数图 SVG，不恢复 PDF 的旧资源配额。图片保留透明通道；不读取 Vault 外文件。客户端将字体和主题图片内嵌为 data URI。浏览器进程关闭文档 JavaScript、网络与文件资源加载，等待字体就绪后打印；不会为静态 CSS 加载用户脚本。
+
+后端依赖 Playwright（已写入 pyproject/uv.lock）。Windows 优先使用本机 Edge/Chrome，可用 `APP_PDF_BROWSER` 指定可执行文件；没有系统浏览器时，在 backend 目录运行 `uv run playwright install chromium`。打印在独立子进程中执行，避免 Windows Uvicorn 事件循环冲突。
+
+不传 print_html 的旧 API 客户端保留 ReportLab 兼容路径，其固定排版不能代表应用主题的实际样式。HTML/DOCX 导出行为不变。主题字体/图片需可从应用资源读取并内嵌，读取失败会报错，避免输出缺失资源却宣称样式一致。