Markdown to HTML Converter

---

name: markdown-to-html

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

triggers:

- convert markdown to html

- markdown to html

- render markdown

- style markdown

---

# 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

Usage Examples

Convert a file with the default light theme:

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

Use the dark theme for a presentation:

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

Pipe from another command:

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

Use in a newsletter pipeline:

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