MD to HTML Effectiveness

将 Obsidian 中的 Markdown 笔记一键转换为符合 html-effectiveness 标准的单文件 HTML。

Convert Obsidian Markdown notes to standalone HTML files following the html-effectiveness standard.

What It Solves

Problem: Obsidian notes are locked inside the app. When you want to share a formatted note as a web page, you need to manually convert it.

Solution: One command converts any .md file to a self-contained .html file:

• Same name and folder, just .html extension
• Single-file, no external dependencies
• Dark theme (GitHub-dark inspired), responsive
• Properly formatted: headings, tables, code blocks, lists, links, images
• Works with file:// protocol — open directly in any browser

Features

• Convert current note — command palette → "Convert current note to HTML Effectiveness"
• Batch convert folder — convert all new .md files in current folder to .html
• Dark/Light theme — settings toggle for output theme
• Same path — output .html file sits next to the .md source

Usage

1. Open any .md note in Obsidian
2. Open command palette → "Convert current note to HTML Effectiveness"
3. A new .html file appears in the same folder

Or batch convert:

1. Open any .md file in the target folder
2. Command palette → "Convert all markdown in folder to HTML"

Output Format

Single-file HTML with:

• Dark (GitHub-dark) or light theme
• Inline CSS (no CDN)
• Responsive layout
• System font stack
• Code syntax highlighting via <pre><code>
• Tables with header styling
• Proper heading hierarchy

Commands

Installation

From Obsidian Community Plugins

Settings → Community Plugins → Browse → Search "MD to HTML Effectiveness"

Manual / BRAT

1. Install BRAT
2. Add repository: yanqingwang/obsidian-md-to-html-effect

Development

cd md-to-html-effect-plugin
npm install
npm run dev
npm run build

License

MIT Copyright (c) 2026 rosswang (Heart and Road Ltd)