huashu-md-html

Convert input files and URLs into Markdown, HTML, or DOCX.

871|98|Updated May 9, 2026
One-click install
npx skills add https://github.com/alchaincyf/huashu-md-html --skill huashu-md-html
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: huashu-md-html
Source: https://github.com/alchaincyf/huashu-md-html/tree/main
Command: npx skills add https://github.com/alchaincyf/huashu-md-html --skill huashu-md-html

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires markitdown, html-to-markdown, trafilatura, markdownify, pandoc, python-docx, Pillow, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill solves the fragmentation of document workflows by providing a unified pipeline that converts any input format—including PDFs, DOCX, PPTX, images, audio, YouTube videos, and web URLs—into clean Markdown, then into polished HTML or publication-ready DOCX. It eliminates the need to manually switch between incompatible tools and ensures consistent, professional output quality for writers, developers, and publishers.

Core Features & Use Cases

  • Universal Document Ingestion: Convert PDFs, Office files, EPUBs, images, audio, and web URLs into clean Markdown using Microsoft markitdown.
  • Professional HTML Publishing: Transform Markdown into four distinct, anti-AI-slop HTML themes (article, report, reading, interactive) using Pandoc, suitable for blogs, technical reports, and long-form content.
  • Publisher-Grade DOCX Generation: Convert Markdown directly into professionally formatted DOCX files with covers, tables of contents, headers, footers, and image embedding—ready for editorial review or submission.
  • Reverse Archiving: Convert existing HTML pages or blog posts back into clean Markdown for version control and reuse.

Quick Start

Use the huashu-md-html skill to convert the attached PDF file 'whitepaper.pdf' into a polished HTML report using the report theme.

Frequently Asked Questions about huashu-md-html

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a PDF to clean Markdown for editing?

Converting a PDF to Markdown uses markitdown to extract text and output clean Markdown. This transforms static PDFs into editable text while preserving core content structure for writers and developers.

Can I convert web URLs directly into publication-ready DOCX?

Yes, you can convert web URLs to DOCX by first using trafilatura to extract clean content from the URL into Markdown. Pandoc and python-docx then render that Markdown into a publication-ready DOCX with covers and tables of contents.

Do I need Pandoc installed to convert Markdown to HTML themes?

Yes, Pandoc is required to convert Markdown into polished HTML. It handles rendering the Markdown into the four distinct HTML themes: article, report, reading, and interactive, ensuring professional typography and layout.

What is the best way to convert Office documents and media into distributable HTML?

The best way to convert Office files and media into HTML is through a unified pipeline that first transforms them into clean Markdown. Pandoc then renders this Markdown into polished HTML with anti-AI-slop themes suitable for blogs and technical reports.

Does this document conversion pipeline handle reverse archiving from HTML back to Markdown?

Yes, the pipeline supports reverse archiving by converting existing HTML pages back into clean Markdown. It uses html-to-markdown and markdownify to strip styling and produce version-control-friendly Markdown for reuse.

What are the limitations when using markitdown for universal document ingestion?

When using markitdown for universal document ingestion, complex formatting from PDFs, Office files, and images may flatten into basic Markdown. The pipeline relies on deterministic conversion, meaning highly stylized layouts might lose their original visual fidelity.