html-to-md

type	skill
lifecycle	stable
name	html-to-md
description	Convert HTML documents to clean Markdown via pandoc
tier	standard
applyTo	**/*html-to-md*,**/*.html
muscle	.github/muscles/html-to-md.cjs
inheritance	inheritable
currency	2026-04-30T00:00:00.000Z
lastReviewed	2026-04-30T00:00:00.000Z

HTML to Markdown

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

Quick Start

node .github/muscles/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