Markdown to HTML

Converts markdown files to self-contained, styled HTML optimized for copying into Google Docs. Tables get proper borders, code blocks are styled, and images are embedded.

Usage

Run the script via bunx:

bunx ~/nixos-config/modules/programs/claude-code/skills/md-to-html/md-to-html.ts "<markdown-file>"

What it does

• Converts markdown to HTML via pandoc (uses nix run if not installed)

• Applies clean, modern CSS (system fonts, bordered tables, styled code blocks)

• Embeds all images as base64 (self-contained)

• Opens the result in the default browser

• User can then Cmd+A, Cmd+C, paste into Google Docs

Output

• Creates /tmp/<filename>.html

• Opens in browser automatically

CSS Features

• System fonts (SF Pro, Segoe UI, etc.)

• Tables: auto-width, 1px borders, grey headers

• Code blocks: light grey background, rounded corners

• Blockquotes: left border accent

• Images: max-width 100%

• Reasonable max-width container (900px)

Notes

• Requires pandoc (script will use nix run nixpkgs#pandoc as fallback)

• Images in markdown must be accessible from the markdown file's directory

• Best results when copying from Safari/Chrome to Google Docs