markdown-to-html Skill (awesome-copilot) for Claude: What It Does and How to Install It

Makes Claude convert Markdown to HTML or write a converter, using marked.js, pandoc, gomarkdown, Jekyll or Hugo.

Installs: 9.9K; on skills.sh
Stars: 40.7K; on GitHub
Files: 15; besides SKILL.md
Updated: Oct 2026; last repo commit

This skill teaches Claude how to turn Markdown into HTML in several ways. It shows what the HTML should look like for basics, code blocks, collapsed sections, math and tables. It then walks through marked.js, pandoc, gomarkdown, Jekyll and Hugo.

It triggers on requests like "convert markdown to html" or "render markdown", and when you work on a templating system that outputs HTML. It bundles no scripts, only a SKILL.md and 15 reference files. Each tool still has to be installed on your machine.

Good for

Developers writing Markdown-to-HTML scripts or build steps
Static site authors using Jekyll or Hugo
Anyone who needs HTML from a folder of .md files

Install markdown-to-html

Claude Code

Copy this prompt.

Install the markdown-to-html skill in Claude Code. Run this command:

npx skills add https://github.com/github/awesome-copilot --skill markdown-to-html

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

Pick one route. The Copilot CLI plugin route installs the whole cms-development plugin: 3 skills (content-management-systems, markdown-to-html, quasi-coder), listed in its plugin.json. The plugin folder holds a plugin.json and a README, and no hooks or MCP config files. The skills CLI and folder routes install just this skill.

Built from the package data we hold. Not yet tested by us.

What's in the skill

When it loads

Convert Markdown files to HTML similar to `marked.js`, `pandoc`, `gomarkdown/markdown`, or similar tools; or writing custom script to convert markdown to html and/or working on web template systems like `jekyll/jekyll`, `gohugoio/hugo`, or similar web templating systems that utilize markdown documents, converting them to html. Use when asked to "convert markdown to html", "transform md to html", "render markdown", "generate html from markdown", or when working with .md files and/or web a templating system that converts markdown to HTML output. Supports CLI and Node.js workflows with GFM, CommonMark, and standard Markdown flavors.

Sections in SKILL.md

When to Use This Skill
Converting Markdown to HTML
Essential Basic Conversions
Code Block Conversions
Collapsed Section Conversions
Mathematical Expression Conversions
Table Conversions
Working with [markedJS/marked](references/marked.md)
Prerequisites
Quick Conversion Methods
Step-by-Step Workflows
CLI Configuration
Using Config Files
CLI Options Reference
Security Warning
Supported Markdown Flavors

Key facts

Author: github/awesome-copilot (repo owner: GitHub; community-contributed)
License: MIT
Installs on skills.sh: 9,913 (Nov 2, 2026)
GitHub stars: 40,666 for the whole github/awesome-copilot repo (Nov 2, 2026)
Last repo commit: Oct 30, 2026
Audits on skills.sh: Gen Agent Trust Hub: pass, Socket: pass, Snyk: pass
What it includes: 16 files including SKILL.md: 15 reference files in references/ (no scripts)
Part of: The cms-development plugin (3 skills, per its plugin.json) for Copilot CLI

What it includes

Markdown-to-HTML pairs for basics, code blocks, collapsed sections, math, tables
Each section links to a matching reference file.
Read · Conversion examples
CLI and Node usage, config files, flavors
Prerequisites include npm install -g marked or npm install marked.
Runs code · marked.js workflow
Convert md to HTML, and to LaTeX, PDF or Word
PDF output needs a LaTeX install. A --sandbox mode is shown for untrusted input.
Runs code · pandoc workflow
Go library and the mdtohtml CLI
Needs Go 1.18 or higher; the CLI comes from go install.
Runs code · gomarkdown/markdown workflow
Static sites with Jekyll and Bundler
Uses gem install jekyll bundler, then bundle exec jekyll build or serve.
Runs code · Jekyll workflow
Static sites with Hugo
Shows hugo new site and adding a theme with git submodule add.
Runs code · Hugo workflow
Each tool section has one
Marked does not sanitize output HTML, so the skill shows DOMPurify for untrusted input.
Read · Security warnings
15 files in references/
Guides on Markdown syntax plus one per conversion approach.
Read · Reference files

From the official docs

Permissions

Medium risk

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

Examples install tools on your machine
SKILL.md lists npm install -g marked, go install github.com/gomarkdown/mdtohtml@latest and gem install jekyll bundler as prerequisites. Approve each install deliberately. github.com
The Hugo example adds a git submodule
The Hugo quick start runs hugo new site, git init and git submodule add for a theme from GitHub. Run it in a new folder, not an existing repo. github.com
Marked output is not sanitized
SKILL.md says marked does NOT sanitize output HTML. Sanitize it before showing untrusted content. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	No read-only mode. Use version control.
Talks to	npm, Go and RubyGems package downloads when you run the install commands. github.com for the Hugo theme submodule example
Sign-in and keys	SKILL.md does not mention any account or key.
Scopes	Reads Markdown files you point it at and writes HTML output Examples install global or project packages with npm, go install and gem install

Questions

What does the markdown-to-html skill do?

It makes Claude convert Markdown to HTML, or write a conversion script. It covers marked.js, pandoc, gomarkdown, and the Jekyll and Hugo static site tools.

How do I install it?

Use the install box at the top of this page. The repo README documents a Copilot CLI plugin, cms-development, that includes this skill along with 2 others. The skills CLI, folder and Claude upload routes install only this skill.

Does it install marked, pandoc or Jekyll for me?

SKILL.md lists them as prerequisites you install, for example npm install -g marked or gem install jekyll bundler. Claude may suggest or run those commands, so review each one.

Is converted HTML safe to publish?

Not automatically. SKILL.md warns that marked does not sanitize output HTML and shows DOMPurify for untrusted input. It also shows pandoc --sandbox for untrusted input.

Which tool should I pick?

SKILL.md covers five options: marked.js, pandoc, gomarkdown, Jekyll and Hugo. Our rough guide: marked.js for Node projects, pandoc when you also need Word or PDF, gomarkdown for Go, and Jekyll or Hugo if your site already uses them.

Is it safe?

It bundles no scripts, only a SKILL.md and 15 reference files. Its examples install packages (npm, go, gem), run Jekyll and Hugo builds and add a git submodule. Review those commands before they run.

Information

updated Nov 2, 2026

Repository: github/awesome-copilot
Folder: skills/markdown-to-html

github/awesome-copilot skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 3

markdown-to-html SKILL.md · github.com
awesome-copilot README · github.com
cms-development plugin.json · github.com