mcpField
C
convert-url-html-to-md

convert-url-html-to-md

github.com/1naichiiDocuments44 installs
Repository

About convert-url-html-to-md

A Claude skill that converts web-page HTML into Markdown using a two-phase workflow. It can first expose navigation links for documentation discovery, then extract main-page content, with output sent to stdout.

Key features

  1. 01Discover documentation links from full pages
  2. 02Extract main content in clean mode
  3. 03Convert page content to Markdown
  4. 04Write output to stdout or a file

Use cases

  1. 01Finding documentation pages from site navigation
  2. 02Converting a specific documentation page
  3. 03Saving extracted content as a Markdown file

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/1naichii/ai-code-tools --skill convert-url-html-to-md

After installing, type/convert-url-html-to-mdin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

package.json
lib/
html_table_to_markdown.js
url_to_markdown_apple_dev_docs.js
url_to_markdown_common_filters.js
url_to_markdown_formatters.js
url_to_markdown_processor.js
url_to_markdown_readers.js
scripts/
convert_url.js

Details

From the project README

Convert URL HTML to Markdown

Extract web content as markdown using a two-phase approach for comprehensive documentation gathering.

Two-Phase Workflow

For optimal documentation extraction:

  1. Discovery (clean=false): Get full page including navigation and sidebars to discover all documentation URLs
  2. Extraction (clean=true): Extract main content from discovered URLs

Usage

# From the skill directory
cd ~/.claude/skills/convert-url-html-to-md

# Clean mode - main content only (recommended for docs)
node scripts/convert_url.js <url> --clean=true

# Full page mode - includes nav/sidebar (for discovering URLs)
node scripts/convert_url.js <url> --clean=false

# Default is clean=true
node scripts/convert_url.js <url>

Examples

# Get all navigation links from a docs site
node scripts/convert_url.js https://ui.shadcn.com/docs --clean=false

# Extract specific documentation content
node scripts/convert_url.js https://ui.shadcn.com/docs/components/radix/aspect-ratio --clean=true

Installation

Dependencies are included. Run once:

cd ~/.claude/skills/convert-url-html-to-md
npm install

Output

The script outputs markdown directly to stdout. Redirect to file if needed:

node scripts/convert_url.js <url> --clean=true > output.md

Credits

This skill is based on urltomarkdown by Lee Hanken, licensed under MIT. Modified and adapted as a Claude skill by 1naichii.

Comments

Markdown supported