# Export to HTML | 导出为 HTML
**将您的 Obsidian 笔记转换为专业级 HTML 文档**
*Transform Your Obsidian Notes into Professional HTML Documents*
[](https://github.com/almoost/obsidianExportHTML)
[](https://github.com/almoost/obsidianExportHTML/blob/main/LICENSE)
[](https://obsidian.md)
---
## 📖 在线预览 | Online Preview
查看实际导出效果：
View the actual export results:
- [📄 演示 HTML](https://justwsh.github.io/obsidianExportHTML/demo/demo.html) - 查看导出后的 HTML 效果
- [📄 Demo HTML](https://justwsh.github.io/obsidianExportHTML/demo/demo.html) - View the exported HTML effect
- [📝 演示源文件](demo/demo.md) - 查看用于导出的 Markdown 源文件
- [📝 Demo Source](demo/demo.md) - View the Markdown source file used for export
---
## 🌟 产品亮点 | Product Highlights
### 🎨 专业风格 | ProfessionalStyle
- 采用经典的配色方案，呈现简洁、专业的视觉效果
- Clean and professional visual presentation with classic color scheme
### 📑 智能目录导航 | Smart Table of Contents
- 自动从笔记标题生成层级化目录
- Automatically generates hierarchical table of contents from headings
- 可调节宽度的侧边栏，适应不同阅读习惯
- Adjustable sidebar width to adapt to different reading preferences
- 平滑滚动定位，提升阅读体验
- Smooth scrolling for enhanced reading experience
### 🖼️ 图片自动嵌入 | Automatic Image Embedding
- 图片自动转换为 Base64 编码嵌入 HTML
- Images automatically converted to Base64 and embedded in HTML
- 无需额外图片文件夹，单文件即可分享
- No need for extra image folders, single file ready to share
- 支持多种图片格式：PNG, JPG, GIF, SVG, WebP 等
- Supports multiple image formats: PNG, JPG, GIF, SVG, WebP, etc.
### 💻 代码块增强 | Enhanced Code Blocks
- 带行号的代码块，方便引用和讨论
- Code blocks with line numbers for easy reference and discussion
- 一键复制功能，快速分享代码
- One-click copy functionality for quick code sharing
- 优化的滚动体验，同步行号显示
- Optimized scrolling with synchronized line numbers
### 📐 数学公式支持 | Math Formula Support
- 支持 LaTeX 格式的数学公式渲染
- Support for LaTeX-style math formula rendering
- 自动检测并渲染行内公式和块级公式
- Automatic detection and rendering of inline and block formulas
- 支持多种公式语法：`$...$`、`$$...$$`、`\(...\)`、`\[...\]`
- Supports multiple formula syntaxes: `$...$`, `$$...$$`, `\(...\)`, `\[...\]`
- 基于 KaTeX 库，渲染快速且美观
- Based on KaTeX library, fast and beautiful rendering
---
## ✨ 核心功能 | Core Features
| 功能 Feature | 描述 Description |
|------------|------------------|
| 🖱️ **右键菜单集成** | 在文件浏览器中右键点击即可导出 |
| 🖱️ **Right-click Menu** | Right-click in file explorer to export instantly |
| 📁 **自定义保存位置** | 自由选择 HTML 文件保存路径 |
| 📁 **Custom Save Location** | Freely choose where to save HTML files |
| 🌐 **双语支持** | 完整支持中文和英文界面 |
| 🌐 **Bilingual Support** | Full support for Chinese and English interfaces |
| 🎯 **智能默认值** | 默认保存至源文件同级目录 |
| 🎯 **Smart Defaults** | Default save to same directory as source file |
| 📤 **一键分享** | 单个 HTML 文件，便于邮件和网页分享 |
| 📤 **Easy Sharing** | Single HTML file, easy to share via email and web |
| 📐 **数学公式渲染** | 支持 LaTeX 格式的数学公式 |
| 📐 **Math Formula Rendering** | Support for LaTeX-style math formulas |
---
## 🚀 使用指南 | Usage Guide
### 快速开始 | Quick Start
1. **选择文件** | Select File
- 在 Obsidian 文件浏览器中找到要导出的笔记
- Find the note you want to export in Obsidian file explorer
2. **右键导出** | Right-click Export
- 右键点击文件，选择「导出为 HTML...」
- Right-click the file and select "Export to HTML..."
3. **保存文件** | Save File
- 选择保存位置（默认与源文件同目录）
- Choose save location (default: same directory as source)
- 点击「保存」完成导出
- Click "Save" to complete export
### 高级功能 | Advanced Features
#### 自定义设置 | Custom Settings
- **导出后自动打开文件夹** | Auto-open folder after export
- 启用后自动在文件管理器中打开导出文件所在目录
- Automatically opens file explorer to the export location when enabled
---
## 📄 许可证 | License
MIT License - 详见 [LICENSE](LICENSE) 文件
See [LICENSE](LICENSE) file for details.
---
## 🙏 致谢 | Acknowledgments
- 感谢 Obsidian 团队提供的优秀笔记工具
- Thanks to the Obsidian team for the excellent note-taking tool
---
**如果喜欢这个插件，请给个 ⭐ Star 支持！**
**If you like this plugin, please give it a ⭐ Star!**
[GitHub 仓库](https://github.com/JustWSH/obsidianExportHTML) | [问题反馈](https://github.com/JustWSH/obsidianExportHTML/issues)
Made with ❤️ by @almoost