README file from
GithubHTML Experience
Open .html, .htm, .mht, and .mhtml files directly in Obsidian with full JavaScript support.
Features
- JavaScript support - Scripts run inside sandboxed iframes
- Dark/Light mode - Floating toggle button to switch themes
- Original colors - Option to disable theme override and see the HTML as designed
- Custom background - Set your own background color
- Zoom controls - Zoom in/out with buttons, Ctrl+scroll, or commands
- Search - Ctrl+F to search, Enter/Shift+Enter to navigate matches
- File watching - Auto-reloads when you edit the HTML externally
- Full screen - Toggle full screen mode
- External links - Links open in your default browser
- MHTML support - Open web archive files
- Error handling - Shows helpful error messages for invalid files
Installation
From Community Plugins (after approval)
- Open Obsidian → Settings → Community plugins
- Search "HTML Experience"
- Install and enable
Manual installation
- Download
main.js,manifest.json, andstyles.cssfrom Releases - Copy to your vault:
.obsidian/plugins/html-experience/ - Restart Obsidian
- Enable "HTML Experience" in Settings → Community plugins
Usage
- Click any
.htmlor.htmfile in your vault to open it - Use the toolbar buttons to zoom in/out/reset
- Press Ctrl+F to search within the HTML
- Click the moon/sun button (bottom-left) to toggle dark/light mode
- Click the expand button for full screen
Settings
| Setting | Description |
|---|---|
| Enable JavaScript | Allow scripts to run in HTML files |
| Sandbox permissions | Advanced: iframe sandbox permissions |
| Custom background color | Override HTML background with a color |
| Show toolbar | Show/hide the zoom controls toolbar |
| Show theme toggle button | Show/hide the dark/light mode button |
| Use original HTML colors | Disable all theme styling |
| MHTML support | Enable opening .mht/.mhtml files |
Commands
- Toggle full screen
- Zoom in / Zoom out / Reset zoom
- Search in HTML view
- Search next / Search previous match
- Reload active HTML view
License
MIT