Skill 2

Convert Markdown text to beautifully styled, self-contained HTML with embedded CSS. Perfect for newsletters, documentation, reports, and email templates.

Markdown to HTML Converter

A zero-dependency Python tool that converts Markdown files into beautiful, self-contained HTML documents with embedded CSS styling. No external libraries needed — uses only Python's standard library.

Features

• Full Markdown support: Headings, bold, italic, strikethrough, links, images, code blocks with syntax hints, blockquotes, ordered and unordered lists, horizontal rules, and tables
• Two built-in themes: Light (GitHub-inspired) and Dark mode with carefully chosen colors
• Self-contained output: All CSS is embedded inline — the resulting HTML file works anywhere with no external dependencies
• Responsive design: Output looks great on desktop and mobile screens
• Stdin support: Pipe content directly for use in shell pipelines

Usage Examples

Convert a file with the default light theme:

bash

python main.py README.md -o readme.html

Use the dark theme for a presentation:

bash

python main.py notes.md -o notes.html --theme dark --title "Meeting Notes"

Pipe from another command:

bash

cat CHANGELOG.md | python main.py - -o changelog.html

Use in a newsletter pipeline:

bash

python main.py issue-42.md --title "Lobster Diary #42" -o issue.html

Supported Markdown Elements

Element	Syntax	Supported
Headings	# H1 through ###### H6	✅
Bold	**text**	✅
Italic	*text*	✅
Strikethrough	~~text~~	✅
Links	[text](url)	✅
Images		✅
Code blocks	Triple backtick with language	✅
Inline code	Single backtick	✅
Blockquotes	> text	✅
Unordered lists	- item or * item	✅
Ordered lists	1. item	✅
Horizontal rules	---	✅

Command Line Options

• input — Markdown file path, or - for stdin
• -o, --output — Output HTML file (defaults to stdout)
• --theme — light (default) or dark
• --title — HTML document title (default: "Document")