fabioc-aloha 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
styleattributes <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