jira导出HTML,原来，这才是 HTML+CSS 导出 Word 最佳方式！

转个word很难吗？

对于任何一个在线富文本写作产品，导出功能是必不可少的，其中导出word是其中最常见的选项，但是很多产品导出的word，比如说Jira，格式就有不同程度的失真.

仔细分析下来，解决这个思路的主要有两种：

硬转：使用OpenXml的SDK，逐一匹配html标签和样式css，相当于用OpenXml实现了一个html+css的渲染层。

偷懒：想办法把html+css的内容当成word的一部分，相当于用web视图打开。

当时，我花了一定的时间，在两个方向上分别做了调研。

硬转的思路，直觉上工作量就极大，而且很容易出Bug，毕竟那么多组合情况需要考虑。值得参考的项目是html2openxml，1W多行只能实现html的转换，还不包括css。

不是没想过，限制输出html的排版，比如用固定的id代表固定的部分，css样式也只支持特定的几种，但后来讨论下来，觉得这种方法，需要前后端确定好规则，而在当时快速迭代的时期，这无疑会增加开发成本。

而偷懒这条路，能够搜索到项目，都是借用了word中altchunks的特性，比如:html-docx-js、html2docx。

问题也很明显，

不支持float之类的样式，对图片的支持也需要自己写代码转base64，然后嵌进标签里。这些虽然麻烦些，但是还是可以tweak。

最麻烦的是，这种格式的word，兼容性很差，在微信中、mac上打不开。

于是，我一度卡在这里很久，直到我发现……

原来，word才是转word的最佳工具

转机来的也很突然，就是我发现用word打开一个带html+css的文件后，再另存成word，不仅格式得到了保留，图片也在，而且兼容性也还不错！真是

踏破铁鞋无觅处，得来全不费工夫。

问题来了，怎么把这一步程序化呢？

这下终于可以用上过去.net的开发经验了，C#是可以通过com组件的方式操作word，但前提是运行程序的机器上必须装word才行。

核心代码，也是非常的简单：

首先引用Microsoft.Office.Interop.Word，调用的代码如下:

var word = new Application {Visible = false};

var doc = word.Documents.Open(htmlFilePath, Format: WdOpenFormat.wdOpenFormatWebPages,

ReadOnly: false);

doc.SaveAs2000(wordFilePath, WdSaveFormat.wdFormatDocumentDefault,

ReadOnlyRecommended: false);

doc.Close();

word.quit()

是不是很简单呢？

而这里唯一还需要处理的就是图片，如果不做处理，图片还是以链接的方式存储的。

一方面，每次打开的时候需要重复下载，好处是word文件比较小，但缺点是受限于网速，可能会出现图片加载不出来的情况;

另一方面时，如果图片没有指定宽度和高度，当图片的尺寸大于文档的尺寸时，显示的效果就很差。

估化的思路很简单，即强行把图片的尺寸拉伸到一页可以显示下，同时将图片链接转成内嵌的图片。

foreach (InlineShape s in doc.InlineShapes)

{

var inlineShape = s;

if (inlineShape.Type != WdInlineShapeType.wdInlineShapePicture &&

inlineShape.Type != WdInlineShapeType.wdInlineShapeLinkedPicture)

{

continue;

}

if (inlineShape.Type == WdInlineShapeType.wdInlineShapeLinkedPicture)

{

inlineShape.LinkFormat.SavePictureWithDocument = true;

inlineShape.LinkFormat.BreakLink();

}

if (inlineShape.Width > this._documentWidth)

{

inlineShape.LockAspectRatio = MsoTriState.msoTrue;

inlineShape.Width = this._documentWidth;

}

if (inlineShape.Height > this._documentHeight)

{

inlineShape.LockAspectRatio = MsoTriState.msoTrue;

inlineShape.Height = this._documentHeight;

}

}

到此，核心的转换代码就已经完成。(需要提醒各位看官的是，这种方法是不支持float和flex的css样式的。)

剩下的工作

请注意：上述代码是基于.net framework写的，运行的机器上还必须有word。

如果要对外提供服务的话，考虑到跨语言跨平台，最好的方式即提供http接口。

而这对一个不熟悉.net的人，那要学习的东西还是不少的。

楼主我就好人做到底，在上述的核心代码上用WCF的webHttpBinding实现了一个的http服务，同时使用log4net实现了日志功能。

最终的程序的workflow是

用户发送html+css内容到http服务

先把html+css存成文件

读取html文件，然后另存为word文件

返回下载链接

使用nginx映射目录中的文件，实现下载功能

所有代码开源在HtmlToWord，如果它对你有用，欢迎点个star.

本作品采用《CC 协议》，转载必须注明作者和本文链接