html-to-md

name	html-to-md
description	Convert HTML documents to clean Markdown via pandoc
lastReviewed	"2026-05-26T00:00:00.000Z"

Html To Md

Convert HTML documents to clean Markdown. Strips inline styles, scripts, and tracking pixels while preserving semantic structure.

Quick Start

node .github/skills/html-to-md/scripts/html-to-md.cjs page.html page.md

What's preserved

• Headings, paragraphs, lists, blockquotes
• Tables (when structure is regular)
• Links and inline code
• Image references (URLs kept as-is)
• Emphasis (bold, italic, strikethrough)

What's dropped

• Inline style attributes
• <script> and <style> blocks
• Tracking pixels and analytics tags
• Most <div>/<span> wrappers (semantic content preserved)

Optional flags

Flag	Effect
--download-images	Fetch referenced images to a local images/ folder
--wrap N	Line wrap width (default: 80)

Post-conversion

• Run lint-clean-markdown over the output to fix heading hierarchy and list spacing.
• HTML often has multiple <h1> tags; Markdown wants exactly one.

Related

• docx-to-md — Word source
• lint-clean-markdown — clean up the result

Would Revise If

Revisit this skill by 2026-08-26 (90 days) or sooner if any of the following fires: pandoc upstream changes html-to-md behavior in a way that breaks the documented flag semantics; the --download-images flow fails on a real source the user runs through it; or lint-clean-markdown post-processing stops being the right finishing step (e.g., a stricter linter ships and the pipeline needs to chain to it instead).