MD Table Image

📊 Markdown 表格秒变精美图片

将 Markdown 表格渲染为美观 PNG 图片,解决聊天场景下表格格式错乱问题,提升可读性与专业度。

收藏
4.4k
安装
1.2k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

md-table-image 是一个基于 Node.js 的 Markdown 表格渲染工具,核心功能是将 Markdown 表格(含管道符语法)转换为样式精美的 PNG 图片。用户可通过命令行直接调用,支持两种方式:

1. 参数传入模式node {baseDir}/scripts/render.mjs "markdown content" -o /path/to/output.png
2. 管道输入模式echo "| A | B |\n|---|---|\n| 1 | 2 |" | node render.mjs -o output.png

可选参数

  • -o <path>:指定输出路径(默认 /tmp/table.png
  • --title <text>:添加表头标题
  • --width <px>:设置视口宽度(默认 800px)
  • --dark:切换深色主题

显著优点

1. 格式保真:彻底解决聊天场景下 Markdown 表格因字体宽度、换行导致的列对齐错乱
2. 视觉美观:内置样式系统,支持深浅主题,输出图片可直接用于演示、文档、社交分享

3. 无依赖侵入:纯命令行工具,不修改原始数据,输出为通用 PNG 格式

4. 自动化友好:支持管道输入,易于集成到 CI/CD 或自动化报告流程

潜在缺点与局限性

1. 运行时依赖:必须预装 Node.js 环境,且需 playwright 或类似浏览器引擎(通常用于 HTML→PNG 渲染),可能存在 Chromium 下载体积大(~100MB+)的问题
2. 交互性丧失:输出为静态图片,无法复制单元格文本、无法排序筛选

3. 动态内容受限:不支持实时数据刷新,每次更新需重新渲染

4. 无障碍问题:图片格式对屏幕阅读器不友好,需配合 alt 文本使用

适合人群

  • 技术文档撰写者:需要在对齐要求高的平台(如微信、飞书、钉钉)分享数据对比
  • DevOps/运维工程师:生成自动化监控报表、配置对比图
  • 产品经理/数据分析师:快速产出可嵌入汇报 PPT 的表格截图
  • 开源社区维护者:在 Issue/Discussion 中展示结构化数据

常规风险

| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 路径遍历 | 若 `-o` 参数未校验,可能覆盖系统关键文件 | 限制输出目录白名单或沙箱执行 |
| 输入注入 | Markdown 内容可能含 HTML/JS,若渲染引擎未隔离可能触发 XSS | 使用无头浏览器时启用 `--no-sandbox` 以外的安全策略,或净化输入 |
| 资源耗尽 | 超大表格或频繁调用可能导致内存/CPU 占用过高 | 设置渲染超时与表格行列上限 |
| 临时文件残留 | 默认 `/tmp` 路径可能堆积未清理文件 | 定期清理或使用带自动清理的临时目录 |

> 注意:当前安全认证报告为占位状态,实际生产环境建议补充依赖扫描(npm audit)、沙箱执行验证及输入过滤测试。

MD Table Image 内容

scripts文件夹
手动下载zip · 13.7 kB
render.mjstext/javascript
请选择文件