Files
MorphDoc/packages/renderer
SkyJourney 58f87cc19f feat: 完成 DOCX R4 元素级视觉门禁
建立 Chromium、Word 与 WPS 的可编辑内容、段落几何、页眉页脚、封面、媒体和逐页视觉比较链路。

支持封面独立分节、正文页码重启、主题页边距与横向纸张,并将自然分页差异降为诊断项。

修正代码块内边距和折叠表格单元格边框映射,14 套主题生产矩阵与六组布局视觉矩阵通过。
2026-08-02 03:27:11 +08:00
..
2026-07-28 18:01:22 +08:00

@md-to-pdf/renderer

将 Markdown 转换为统一、安全的 #write HTML 文档。Web 预览、服务端 PDF 和桌面端 PDF 均通过应用服务复用本包,不维护第二套 Markdown 解析 逻辑。

目录结构

src/
  render-markdown.ts  Front Matter、Markdown 扩展、安全过滤与元数据
  index.ts            公共导出入口
tests/
  render-markdown.test.ts

支持能力

  • 标题锚点、表格、任务列表、脚注和代码高亮;
  • markdown-it 原生围栏代码块及 Typora .md-fences DOM 兼容;
  • KaTeX 数学公式;
  • Mermaid 安全占位;
  • @md-to-pdf/markdown-echarts ECharts YAML 围栏;
  • 图片标题 DOM 与资源引用收集;
  • 保留由 Web/Desktop 平台适配器处理的安全文档链接;
  • sanitize-html 白名单过滤和统一 <article id="write"> 输出。

使用

import { renderMarkdown } from "@md-to-pdf/renderer";

const result = renderMarkdown("# 示例", {
  language: "zh-CN"
});

普通围栏代码块输出为:

<pre class="md-fences" lang="ts"><code class="language-ts">...</code></pre>

.md-fences 让 Typora 主题负责完整代码块外观;共享预览引擎会移除内部 code 重复套用的行内代码盒模型,同时保留 highlight.js 的高亮 span。 Mermaid 和 ECharts 围栏继续使用各自的专用 DOM,不经过该分支。

实际应用优先通过 @md-to-pdf/application 调用,以便同时完成主题和图片 资源处理。

开发与验证

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