markdown-to-html
by claudiodrusus
Web & Frontend DevelopmentBrief
Convert Markdown text to beautifully styled, self-contained HTML with embedded CSS.
Description
What This Skill Does
Converts Markdown files to self-contained HTML documents using only Python's standard library. All CSS is embedded inline, so the output works without external dependencies or a web server. Supports light and dark themes, stdin piping, and a full range of Markdown elements including tables and code blocks.
Because all CSS is embedded inline, the output file is fully portable and works in any browser or email client without a server, build step, or installed packages.
When to Use It
- Converting a project README into a shareable HTML page
- Building styled email newsletter issues from Markdown drafts
- Generating offline-readable documentation without a static site generator
- Producing formatted release notes from a CHANGELOG file
- Creating dark-mode meeting notes for presentation or archiving
Example Workflow
User asks: Convert my notes.md to a dark-themed HTML file titled 'Meeting Notes'
- 1
Locate notes.md in the working directory
- 2
Run python main.py notes.md -o notes.html --theme dark --title "Meeting Notes"
- 3
Verify the output file is written to disk
- 4
Confirm the HTML opens standalone in a browser with no external requests
notes.html, a self-contained HTML file with dark theme styling, an embedded title, and no external dependencies
Installation
clawhub install claudiodrusus/markdown-to-htmlRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.