huashu-md-html

A document pipeline skill: anything to markdown, markdown to clean html and publisher-grade docx, and html back to markdown

Skill

Medium risk

We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.

Why this level

  • Runs external tools and reads files
  • Can fetch web page content by URL
All reasons and checks

alchaincyf/huashu-md-html

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/huashu-md-html

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

Run in a terminal in the project folder

npx skills add alchaincyf/huashu-md-html --skill huashu-md-html -a claude-code -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add alchaincyf/huashu-md-html --skill huashu-md-html -a cursor -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add alchaincyf/huashu-md-html --skill huashu-md-html -a github-copilot -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add alchaincyf/huashu-md-html --skill huashu-md-html -a codex -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add alchaincyf/huashu-md-html --skill huashu-md-html -a gemini-cli -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add alchaincyf/huashu-md-html --skill huashu-md-html -a cline -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add alchaincyf/huashu-md-html --skill huashu-md-html -a roo -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

A fork of Roo Code, same .roo folders.

Run in a terminal in the project folder

npx skills add alchaincyf/huashu-md-html --skill huashu-md-html -a opencode -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

You will need: Node.js

Checked against the repository on Sep 25, 2026, commit 17192f5.

Text for your agent

Install the skill: npx skills add alchaincyf/huashu-md-html. Install the dependencies from requirements.txt; docx and conversions need Pandoc.

Other ways from the author
npx skills add alchaincyf/huashu-md-html

Then install the dependencies from requirements.txt; docx needs Pandoc.

This is third-party code. Review the repository files before installing.

What it does

The skill combines several document conversions into one pipeline. It turns almost any file (PDF, DOCX, PPTX, XLSX, EPUB, image, audio, a web page URL) into clean markdown, then styles markdown into tidy html with one of its prepared themes or builds a publisher-grade docx from it with a cover, table of contents, embedded images and headers and footers. It also goes the other way: published html can be pulled back into markdown for archiving. Each conversion is a separate command, and the themes passed an anti-AI-slop checklist, so no acid gradients or emoji as icons. Underneath it wires together markitdown, Pandoc, trafilatura and html-to-markdown.

Who it is for. For writers, editors and technical writers who need to move documents between markdown, html and docx.

Good fit when

  • You need clean markdown from a PDF, DOCX or web page
  • You need to style markdown into tidy html or docx
  • You need to pull published html back into markdown

Not a fit when

  • You need a single format without conversions
  • You cannot install external tools like Pandoc

Example request

Turn this PDF into clean markdown, then style it into html with a calm theme

Limitations

The skill relies on external tools (markitdown, Pandoc, trafilatura) that you install from requirements.txt, which needs Python. Extraction quality depends on the source file, and complex layouts or scans may need manual fixes. The themes are fixed; the skill does not draw arbitrary designs.

How to disable. Remove the huashu-md-html skill folder from your agent's skills directory.

Security check

  • Runs external tools and reads files
  • Can fetch web page content by URL

README in short

The README describes the skill as a multi-way document pipeline: anything to markdown, markdown to tidy html or publisher-grade docx, and html back to markdown. Each conversion is a command, and four themes passed an anti-AI-slop check. Underneath it wires markitdown, Pandoc, trafilatura and html-to-markdown. Install is via npx skills add and the skill is agent-agnostic. MIT licensed.

FAQ

Which formats convert to markdown?

PDF, DOCX, PPTX, XLSX, EPUB, images, audio and web pages by URL.

Do I need anything besides the skill?

Yes, the external tools from requirements.txt, including Pandoc for docx and conversions.

Official

Microsoft's utility and MCP server that turn PDF, Word, Excel, PowerPoint, HTML and other files into Markdown for models

MCP serverMedium risk187.4KRepository stars
Editors’ pick

Anthropic's official skill examples: docx, pdf, pptx and xlsx documents, design, MCP builder and the Agent Skills spec

SkillMedium risk178.8KRepository stars
Editors’ pick

A skill that builds editable PPTX decks from PDF, DOCX, URLs and Markdown with native shapes, charts and animations

SkillMedium risk56.8KRepository stars
Editors’ pick

A skill that draws editorial diagrams as standalone HTML and SVG files: architecture, flowcharts, ER, funnels and about forty more types

SkillMedium risk42.6KRepository stars
Foxx AIhuashu-md-html

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.