Skip to content

导入导出 ​

顶部「导入」「导出」两个入口,各自能单独关、格式能逐项配。转换全在本地完成,DOCX 依赖按需动态加载,不进首包。

配置 ​

js
new LarkDoc({
  element: '#editor',
  features: { importExport: true },     // 总闸:false 时两个入口一起消失
  importExport: {
    importEnabled: true,                 // false = 只留导出
    exportEnabled: true,                 // false = 只留导入
    importLabel: '导入', exportLabel: '导出',
    importFormats: ['html', 'json', 'md', 'docx'],
    exportFormats: ['html', 'json', 'md', 'txt', 'docx', 'print'],
  },
})

三层逐级收窄,按需组合:

层作用例子
features.importExport两个入口一起开关false
importEnabled / exportEnabled只关其中一个入口importEnabled: false
importFormats / exportFormats格式白名单 + 顺序exportFormats: ['md', 'html']

格式对照 ​

id导入导出说明
html.html .htm✅媒体写法由 media.htmlMode 决定,见图片
json.json✅唯一无损往返格式,要来回编辑就用它
md.md .markdown✅导出是简化版,表格 / 分栏 / 高亮块退化成顺序文本
docx.docx✅导出是纯文本段落,面向归档不还原排版
txt—✅只有正文文字
print—✅调浏览器打印,可存成 PDF;打印前自动展开折叠块

几个细节:

  • 两边格式互不影响:只允许导入 Markdown 的同时导出全部格式,是合法配置;
  • importFormats 同时决定文件选择框的 accept,选中白名单外的扩展名会被挡下并提示,不会静默失败;
  • 数组按内置目录去重;传空数组或全非法值会回落到默认列表,避免配错后入口变成死的。

DOCX 只做归档

DOCX 导出是「标题 + 段落文字」,不还原飞书式排版。要高保真 Word 交付,建议导 HTML 后由宿主自己转换。