release: 发布 v0.4.5

新增能力：Web 与 Desktop 支持新建和保存 Markdown；桌面端注册 .md/.markdown 打开程序，支持单实例文件转交、自定义主题目录以及窗口位置、尺寸和最大化状态的延迟原子持久化与屏幕越界修正。界面与兼容性：保留打开 Markdown 为独立主操作，将新建、保存和主题目录收纳到更多菜单；Web 移除本地素材目录入口并明确默认不支持本地素材；新文档默认使用一级标题或首行合法化生成文件名，可不保存直接导出 PDF。渲染修复：图片、Mermaid 和 ECharts 按文档顺序串行执行媒体分页回填，每个媒体元素至多重排一次；图片以限宽后的高度作为缩放基准，只缩放媒体主体并保持标题尺寸；ECharts 冻结为 SVG 图片后参与统一分页。示例与文档：默认示例仅保留一张网络图片，增加有效 Base64 横图、竖图、边界图片及多尺寸 Mermaid/ECharts；更新根 README、Desktop README、部署文档、四个 packages README、PROGRESS 和 AGENTS 发布规范；登记 v0.4.6 超链接导航问题。部署与验证：构建并运行 yixiong/md-to-pdf:v0.4.5 正式镜像，Compose 健康且 PDF 冒烟无 Mermaid/ECharts 错误；生成 NSIS 安装包和免安装 ZIP，本机已升级到 NSIS v0.4.5 并清理旧 Squirrel 安装；202 项测试、类型检查、生产构建和 git diff --check 全部通过。发布产物：Setup.exe SHA-256 9CBD6362E15AA745185805E753D5A7749434E0E142E6CE0F66463E6A19468F1D；ZIP SHA-256 97B2D44E72F626A3396E5AB5B330FFB7F9BECAF945A1707808C876940A82E850；当前 Windows 产物未配置代码签名。
2026-07-28 13:31:42 +08:00
parent ac54ce46be
commit 925b0d1485
35 changed files with 3125 additions and 603 deletions
@@ -0,0 +1,46 @@
+# @md-to-pdf/renderer
+
+将 Markdown 转换为统一、安全的 `#write` HTML 文档。Web 预览、服务端
+PDF 和桌面端 PDF 均通过应用服务复用本包，不维护第二套 Markdown 解析
+逻辑。
+
+## 目录结构
+
+```text
+src/
+  render-markdown.ts  Front Matter、Markdown 扩展、安全过滤与元数据
+  index.ts            公共导出入口
+tests/
+  render-markdown.test.ts
+```
+
+## 支持能力
+
+- 标题锚点、表格、任务列表、脚注和代码高亮；
+- KaTeX 数学公式；
+- Mermaid 安全占位；
+- `@md-to-pdf/markdown-echarts` ECharts YAML 围栏；
+- 图片标题 DOM 与资源引用收集；
+- `sanitize-html` 白名单过滤和统一 `<article id="write">` 输出。
+
+## 使用
+
+```ts
+import { renderMarkdown } from "@md-to-pdf/renderer";
+
+const result = renderMarkdown("# 示例", {
+  language: "zh-CN"
+});
+```
+
+实际应用优先通过 `@md-to-pdf/application` 调用，以便同时完成主题和图片
+资源处理。
+
+## 开发与验证
+
+```powershell
+npm run dev -w @md-to-pdf/renderer
+npm run test -w @md-to-pdf/renderer
+npm run typecheck -w @md-to-pdf/renderer
+npm run build -w @md-to-pdf/renderer
+```