文档编辑器
导出 PDF / DOCX
内置 Pandoc 链路 — 文档可一键导出 PDF / DOCX / HTML。
导出链路
Kition 的导出基于 Pandoc — 工业级 Markdown 转换器,几乎能转任何格式。Kition 把它包成一个友好的对话框:选样式、选目标格式、点 Export,剩下的交给 Pandoc。
所有导出都在本地完成 — 不上传文档到任何服务器。这对法律 / 医疗 / 财务这类敏感场景至关重要。
步骤
- 命令面板 → "Export to PDF / DOCX / HTML"
- 选样式(
default/academic/minimal/ 自定义) - 选范围:当前文档 / 选区 / 一个文件夹下所有文档(合并)
- 可选附加 CSS(自定义字体、边距、页眉页脚)
- 点 Export — 默认输出到
~/Downloads,可改路径
样式定制
Settings → Export 里可以放自己的 CSS 文件,会自动出现在样式下拉里。CSS 支持完整的 @page 规则,可以控制页边距、纸张大小、页眉页脚的内容。
想用公司模板?把 .docx reference 文件放到 Settings → Export → "DOCX template",Pandoc 会按这个模板的样式输出。
@page {
size: A4;
margin: 2cm 2.5cm;
@top-center { content: "Internal — Kition Engineering"; font-size: 9pt; color: #888; }
@bottom-center { content: counter(page) " / " counter(pages); font-size: 9pt; }
}
body { font-family: "Inter", "PingFang SC", sans-serif; line-height: 1.6; }
h1 { page-break-before: always; }
code { font-family: "JetBrains Mono", monospace; font-size: 0.92em; }注意事项
- PDF 导出需要本地安装 Pandoc — Kition 启动时自动检查;缺失会有引导链接
- LaTeX 路径(高质量 PDF)还要装
xelatex或lualatex - DOCX 不支持 callout 原生类型 — 会降级成带颜色的引用块
- 中文 PDF 默认用系统字体;想内嵌字体在 CSS 里写
@font-face - 导出大文档(>200 页)建议拆章节分别导出再合并
常见问题
- 中文方块乱码 → 字体未安装,装
Noto Sans CJK或换 CSS 字体 - 公式跑出页边 → KaTeX 行内公式过长,改成块公式或者缩小字号
- 图片缺失 → 用了相对路径但目标目录变了,导出前在 Settings → Export 勾「Inline images as base64」
- Mermaid 不渲染 → 检查代码块语言标签是否写对(必须是
mermaid,不是Mermaid)