Markdown 转换导出 HTML 网页步骤教程
您可以直接将正在编辑的文档转换为一个精美、闭合的单文件 .html 静态页面,并在任何设备上随时随地查阅。
🌐 什么是 HTML 导出?它的优势是什么?
普通的 Markdown 文件需要依赖特定的解析软件才能被阅读。如果您将其导出为 HTML 静态网页:
- 零依赖、随时双击打开:生成的
.html页面在任何手机、平板、电脑的浏览器上直接双击均可完美打开,无需任何额外插件。 - 静态图表持久保留:内置的 Mermaid 关系图、Vega-Lite 统计图和 KaTeX 公式都已在导出前被解析编译成了网页内的静态代码/SVG,哪怕离线状态下也依旧可以完美呈现。
- 适合线上部署与分享:您可以直接将此 HTML 文件上传到您的服务器、GitHub Pages 等静态托管空间,快速作为产品文档、个人博客、或说明书发布。
🚀 转换导出 HTML 的步骤
1
进入导出控制面板
在编辑器顶部的操作栏右侧点击 “导出文件” 按钮(如果在文档库列表上,可以悬停在该文档上点击右下角的 “导出”图标)。
2
选择 HTML 网页格式并导出
在弹出的侧边栏面板中,点击 “导出 HTML 网页 (.html)” 选项卡。
3
生成并自动下载
编辑器会在后台启用
MarkdownToHtml 引擎,自动加载 GitHub Light 经典渲染主题、Prism 代码语法高亮以及 KaTeX 数学字体,并开始并行渲染 Mermaid 图表。处理完成后,浏览器将自动开始下载名为 [原文件名]_it365.janqi.com__.html 的自闭合网页文件。
💡 提示与设计细节
- 导出的 HTML 默认采用优雅的 GitHub 极简风格进行展示,对于长文档自带良好的可读性。
- 图表会采用高清无损的 SVG 图像元素直接内嵌在 HTML 文件中,因此放大和缩小时图表不会模糊失真。