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
- 01Discover documentation links from full pages
- 02Extract main content in clean mode
- 03Convert page content to Markdown
- 04Write output to stdout or a file
Use cases
- 01Finding documentation pages from site navigation
- 02Converting a specific documentation page
- 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-mdAfter installing, type/convert-url-html-to-mdin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
package.jsonlib/html_table_to_markdown.jsurl_to_markdown_apple_dev_docs.jsurl_to_markdown_common_filters.jsurl_to_markdown_formatters.jsurl_to_markdown_processor.jsurl_to_markdown_readers.jsscripts/convert_url.jsDetails
From the project READMEConvert 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:
- Discovery (clean=false): Get full page including navigation and sidebars to discover all documentation URLs
- 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.