marknative

将 Markdown 渲染为分页 PNG / SVG，无需浏览器。

适用场景

• - Markdown 转图片
• 批量导出文章、笔记、文档
• 服务端渲染，不想依赖 Chromium

先决条件

bash
npm ls marknative skia-canvas

如果未安装：

bash
npm install marknative

最小示例

ts
import { renderMarkdown } from marknative
import { writeFile } from node:fs/promises

const markdown =

Hello, marknative

• - 项目 1
• 项目 2

const pages = await renderMarkdown(markdown, { format: png })

for (const [i, page] of pages.entries()) {
await writeFile(page-${i + 1}.png, page.data)
}

常见参数

• - format: png | svg
• painter：自定义绘制器，通常暂不使用

调试顺序

1. 1. 先运行最小示例
2. 确认能输出 1 页
3. 再添加表格、引用、代码块
4. 出现排版问题，先检查字体、换行和内容长度

注意事项

• - 这是一个兼容 ESM / TypeScript 的库
• 直接导入源码时，需确保运行环境支持 TS/ESM
• 在非 Bun 环境中，使用 tsx 或兼容 Node TS 的方式更稳定
• skia-canvas 是绘制后端，安装失败时请先检查系统架构和 Node 版本