# @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
```