Markdown Offline Publisher

将 Markdown 文档导出为带左侧目录的离线单文件 HTML，支持 Mermaid、表格和代码块。

使用

• 在 VS Code 文件资源管理器中右键 .md 或 .markdown 文件，选择“导出为离线 HTML”。
• 在 Markdown 编辑区内右键，选择“导出为离线 HTML”。
• 也可以点击编辑器标题栏的导出图标，或从命令面板运行同名命令。

默认在源文件同目录生成同名 .html。文件已存在时会先确认是否覆盖。

执行导出后会先显示“导出设置”面板，可以为本次导出调整页面标题、页面模式、表格默认模式、图片处理、目录深度、输出位置和导出后打开选项。

图片默认采用“嵌入本地图片”：相对路径以 Markdown 文件所在目录为基准，图片转换为 Data URI 写入 HTML。也可以选择同时下载并嵌入网络图片，或保留所有原始链接。找不到的图片不会阻止导出，失败详情会写入输出频道。

显示模式

• 文档模式：正文居中显示，适合阅读与打印。
• 通栏模式：页面使用全部可用宽度，普通文字仍保持合理行宽，表格、图片、代码和 Mermaid 使用更大的内容区域。

生成后的页面可在顶部切换两种模式。图片和 Mermaid 支持适合宽度、原始大小、放大和缩小。

表格默认使用通栏模式，按内容自然分配列宽而不强制铺满页面；每张表格右上角可以单独切换为紧凑模式。Mermaid 和普通图片默认左对齐。

设置

• markdownOfflinePublisher.layoutMode：初始显示模式。
• markdownOfflinePublisher.tocDepth：左侧目录深度，支持 2–6 级。
• markdownOfflinePublisher.tableMode：表格的默认显示模式。
• markdownOfflinePublisher.imageMode：图片嵌入方式。
• markdownOfflinePublisher.outputLocation：同目录导出或每次选择位置。
• markdownOfflinePublisher.openAfterExport：完成后是否立即打开。

扩展不会上传文档。默认模式不需要网络连接；只有主动选择“嵌入本地及网络图片”时，才会访问文档中引用的图片地址。