文档生成兼容性如何
在日常网络运维中，自动生成配置文档、变更记录或巡检报告几乎是家常便饭。但很多人遇到过这种情况：脚本跑得好好的，生成的Word或PDF打开却乱码，表格错位，甚至图片直接不显示。这时候就得问一句：文档生成兼容性如何？
这个问题看似不大，真碰上了却挺闹心。比如你熬夜写了个自动化巡检工具，结果给领导导出的PDF在Mac上打不开，Windows上字体还变了样，印象分立马打折。
格式输出不统一是常见坑
很多运维工具用Python的docx或reportlab生成文档，但这些库在不同系统上的表现有差异。比如python-docx默认用Calibri字体，而Linux服务器上没这字体，转成PDF时就可能替换成DejaVu，排版自然走样。
还有更尴尬的：你在CentOS上生成的.docx文件，发到同事的Office 2016里打开，列表缩进全乱了。这是因为不同版本的Word对OpenXML解析存在细微差别，尤其是用了样式继承或复杂表格的时候。
跨平台查看体验差
有些团队习惯用WPS打开文档，问题更多。WPS对某些Word高级功能支持不够，比如自定义编号样式或多级标题链接。你辛辛苦苦做的目录，到了对方那里点不动，层级也展不开。
更别说用手机查看的情况。现在很多审批流程走移动端，生成的PDF如果没做优化，在小屏幕上文字挤成一团，用户只能不断缩放拖动，体验极差。
推荐几个实用做法
与其依赖复杂的文档库，不如简化输出格式。我们组现在优先生成Markdown，再通过pandoc转成多种格式。这样源头统一，输出可控。
pandoc report.md -o report.docx -f markdown -t docx
pandoc report.md -o report.pdf -f markdown -t pdf这样做还有一个好处：你可以提前定义好模板。比如用--reference-doc指定一个Word模板，确保所有输出文档的字体、页眉页脚都一致。
如果是纯技术文档，干脆只出HTML。浏览器兼容性比办公软件好太多，还能加交互元素，比如折叠代码块或动态图表。本地打开没问题，丢到内网Web服务上也能看。
最后提醒一点：别忘了测试。生成完文档，至少在Windows、macOS和Linux上各抽一台机器验证一遍，特别是目标读者常用的设备和软件版本。一个小动作，能避免后续一堆解释工作。