aardio 文档

HTML 子集原生导出 DOCX

string.html.toDocx 仅为 string.markdown.toDocx 提供有限 HTML 子集适配,不是独立的通用网页转换器或浏览器排版引擎。它将标签解释为结构化 Word 内容,再调用 fsys.openXml.docx.builder;样式、Word XML、编号、关系与包结构只由基础库生成,保存统一交给 fsys.openXml.writer。

需要 fsys.openXml 0.13.0+ 及配套 zlib。生成过程不依赖 Office、MSXML、COM 或 .NET。无需先把 HTML 包装为 RTF,也不使用 altChunk。

import string.html.toDocx;

var html = '<h1 id="intro">标题</h1><p>Hello <b>bold</b> world。</p><ol start="3"><li>第三步</li><li>第四步</li></ol><p><a href="#intro">回到标题</a></p>';
var path,err,report=string.html.toDocx.save("/html-output.docx",html);
if(!path){print(err);return;}
raw.explore(path,"/select");

API

save 直接使用公共 writer 的同目录临时包/原子提交,不创建逐 XML 部件的临时目录。二进制构造入口仍需一个临时 ZIP 文件,读取后删除;buildParts 不进行文件 IO。可在 options 中透传 writer 的 maxEntries/maxPartBytes/maxWriteBytes/level/protectPaths;默认每部件 16 MiB、总写入 128 MiB,超限明确失败。

详细选项、字体说明和降级行为见 Markdown DOCX 指南。

HTML 处理约定

支持范围以 Markdown 输出所需的标签为主,不承诺任意网页及其它富文本软件的逐像素一致性。

Markdown 格式