返回博客
3 分钟阅读
MarkdownToImage

让 Markdown 表格在分享时也能读清楚

从 PNG、JPEG、PDF 的格式比较表出发,检查 Markdown 表格的表头、分隔行、换行和列宽。遇到八列宽表时,先删去与选择无关的列,再按共同标识拆表,必要时改用 PDF 文档交付;导出后逐格逐行核对,保留可复制的文字原稿,避免重要说明被截掉或缩得太小。

让 Markdown 表格在分享时也能读清楚

Markdown 表格在编辑器里看着整齐,转成图片后却可能很难读。关键是每个单元格能分到多少宽度。需要文档交付时,可以打开表格转 PDF;需要分享图片时,先确保表格脱离原页面也能让人看懂。

一张表解决一个选择问题

好的对比表中,每一行承担相同的任务。下面的示例依次列出格式、适合的用途以及取舍,不把某个格式说成所有场景下的赢家,而是帮助读者在文字图片、照片和多页文档之间作选择。

表头要短,也要具体。适用于整张表的限定说明,放在表格前后用一句话交代,不要在每个格子里重复。示例中的格式特点属于定性建议,并不是文件大小的实测基准。

表格原稿与渲染结果

分隔行定义了三列,这里的冒号表示左对齐。将原稿粘贴到 Markdown 转换器,可以检查转成图片后的布局。

# Export format comparison

| Format | Good at | Trade-off |
|:--|:--|:--|
| PNG | Sharp text and diagrams | Larger files |
| JPEG | Photographs | Lossy small text |
| PDF | Multi-page reading | Fixed page layout |

用三列表格比较 PNG、JPEG、PDF 的用途与取舍

这张图适合放在简短的导出指南中,或用于团队讨论交付格式。检查优点和取舍是否仍与正确的行对应。如果文字换行,增加的行高也不应妨碍横向比较。

宽表放不下时怎么处理

假设实际表格包含八列:格式、负责人、价格、状态、平台、大小、截止日期和备注。增加导出宽度可能避免单元格内换行,但整图缩到信息流里时,文字又会变得很小。先删掉与当前选择无关的列。

接着可以拆成两张表,并保留相同的首列来标识条目。长备注移到对应表格下方。如果文档确实需要全部八列,就选择 PDF 布局并检查分页,不要把所有内容缩成一张难读的小图。

不只看外框,还要逐行读一遍

导出前检查单元格文本里意外出现的竖线、缺失的分隔符,以及含义不明确的空白表头。除非已经确认渲染器支持,否则不要依赖原始 HTML 制作复杂的单元格布局。

导出后先读最长的单元格,再从左到右核对完整的一行。即使标题很好看,某个重要限定说明仍可能被截掉。如果读者需要复制或进一步比较内容,也要提供文字形式的源表格。

结构整理清楚后,制作表格 PDF 交付文件。

延伸阅读:Markdown 转 PDF与 避免常见 Markdown 错误。

Markdown To Image | 让 Markdown 表格在分享时也能读清楚 | MarkdownToImage