Skip to content

Latest commit

 

History

History
37 lines (23 loc) · 3.27 KB

export.md

File metadata and controls

37 lines (23 loc) · 3.27 KB

文件导出:HTML / PDF / DOCX

把当前正在编辑的 Markdown 文档导出成 HTML、PDF 或 Word(DOCX)。转换在本地完成,不需要外部服务或命令行工具。

怎么导出

标题栏 文件菜单 → 导出为 → 选格式;也可在命令面板(Ctrl+Shift+P)执行「文件:导出为 …」。导出的是当前文档。内置 HTML / PDF / DOCX 始终可用;若系统装有 pandoc,「导出为」会多出 ODT / RTF / LaTeX / EPUB / Typst / Org 等格式(详见下方「更多格式」)。

  • HTML / DOCX:弹出系统保存对话框,选好位置即落盘。
  • PDF:弹出系统打印对话框,在目标里选「另存为 PDF」保存(也可直接打印到纸)。

三种格式

  • HTML:单文件,内联阅读和打印样式,并嵌入可读取的本地图片。文中保留的远程图片仍可能依赖网络,不能把所有导出都视为完全离线自足。
  • PDF:走系统打印通道生成,版式与 HTML 一致,适合分发和打印。
  • DOCX:标准 Word 文档,标题、段落、加粗 / 斜体、列表、引用、代码、表格都会映射成对应的 Word 元素,可继续在 Word / WPS 里编辑。

内容如何转换

  • Markdown 的标题、强调、列表、引用、代码块、表格和链接映射到目标格式;可读取的本地图片会嵌入,无法读取的图片不能保证完整呈现。
  • 数学公式:HTML/打印中的 $...$、$$...$$、```math 经 KaTeX 输出 MathML;latex / typst 围栏保留代码源码。DOCX 使用自己的元素转换,不等于 Word 原生公式或完整 TeX 排版。
  • Wiki 双向链接 [[...]]:普通链接导出为显示文字(有别名取别名);合法的公式标签引用在 HTML 中生成文内链接和对应编号。
  • 学术内容:HTML 公式编号沿用当前文档顺序,引用与参考文献按现有导出流程处理,详见公式编号与引用。
  • 正文 HTML 按规则转义,链接只保留允许的协议;javascript: 等非准入链接不执行。合法内嵌图片可使用 data:image/,与普通链接的协议规则不同。

更多格式(需系统 pandoc)

InkStream 不打包 pandoc(约 150MB),而是检测系统 PATH 上有没有装 pandoc。装了的话,「导出为」菜单和命令面板会多出 ODT / RTF / LaTeX / EPUB / Typst / Org 等格式,由 pandoc 从 GitHub 风格 Markdown 转换;没装就只显示内置三格式。安装 pandoc 后重启 InkStream 才能看到这些入口。

水印与标识

  • 水印页脚:可在文末附一行自定义水印文字,默认关闭。在 设置 → 通用 → 导出水印页脚 打开,再到「水印文字」里填想要的内容(如版权信息、作者名);留空就不附页脚。
  • 元数据:无论水印开关如何,生成器标识(含版本号)始终写入文件元数据(HTML 的 <meta generator> / DOCX 的核心属性),这是不可见的元信息,不影响正文。

「文件 → 导出为 → 公式 PDF 片段…」另用于当前 LaTeX 公式,输出范围与整篇文档的「PDF…」不同;支持范围见公式 PDF 片段。

← 返回 功能文档总览