baoyu-url-to-markdown

Convert web pages to markdown via Chrome CDP and Defuddle.

2|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/AICode-Nexus/website --skill baoyu-url-to-markdown-aicode-nexus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: baoyu-url-to-markdown
Source: https://github.com/AICode-Nexus/website/tree/main/skills/baoyu-url-to-markdown
Command: npx skills add https://github.com/AICode-Nexus/website --skill baoyu-url-to-markdown-aicode-nexus

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires baoyu-chrome-cdp, defuddle, jsdom, linkedom, turndown, turndown-plugin-gfm, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill fetches web pages and converts them to markdown, saving users the time and effort of manually formatting content.

Core Features & Use Cases

  • Web Page Conversion: Fetches any URL and converts the rendered HTML to clean markdown.
  • Chrome CDP: Uses Chrome's Chrome DevTools Protocol for full JavaScript rendering.
  • Defuddle Integration: Utilizes Defuddle for enhanced web-component handling and YouTube transcript extraction.
  • Fallback Mechanism: Automatically falls back to the pre-Defuddle HTML-to-Markdown pipeline when needed and falls back to the hosted defuddle.md API if local capture fails.
  • Use Case: When you need to save a webpage as markdown for easy access or sharing.

Quick Start

Convert a webpage to markdown using the command: ${BUN_X} {baseDir}/scripts/main.ts <url>

Frequently Asked Questions about baoyu-url-to-markdown

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

FAQPage Schema
How do I convert a web page to markdown format?

To convert a web page to markdown, this Skill fetches rendered HTML via Chrome CDP and transforms it into clean markdown using Defuddle. It executes a simple script command to instantly output formatted text from any URL for content capture.

Does web page conversion work with JavaScript-heavy sites?

Yes, web page conversion works with JavaScript-heavy sites by utilizing Chrome DevTools Protocol (CDP) for full rendering. This ensures dynamic content is fully loaded before Defuddle extracts the HTML and converts it to markdown.

Can I extract YouTube transcripts when converting HTML to markdown?

Yes, you can extract YouTube transcripts when converting HTML to markdown because the Skill integrates Defuddle for enhanced web-component handling. This specialized extraction captures video transcripts alongside standard web page content.

Do I need Chrome and bun installed to use this HTML to markdown converter?

Yes, you need Chrome, bun, npx, and Defuddle installed to use this HTML to markdown converter. Chrome provides the DevTools Protocol for rendering, while bun executes the conversion scripts to fetch and process URLs.

What happens if local web page conversion fails?

If local web page conversion fails, the system automatically falls back to a legacy HTML-to-Markdown pipeline using turndown. If that also fails, it falls back to the hosted defuddle.md API to ensure you still get markdown output.