Markdown.new Skill

Single-skill repository for markdown-new - official Cloudflare URL-to-Markdown service (markdown.new) converted into a skill.

Skill entrypoint:

• markdown-new/SKILL.md

What It Does

markdown-new converts public web pages into LLM-ready Markdown using markdown.new, with:

• URL-to-Markdown conversion for summarization, extraction, RAG, and archiving
• conversion fallback control (auto, ai, browser)
• optional image retention
• optional wrapped delivery mode for downstream parsing

Path Resolution (Important)

• Relative paths such as scripts/markdown_new_fetch.py are relative to the skill directory.
• Do not run python3 scripts/markdown_new_fetch.py ... from workspace root unless scripts/ exists there.
• Safe command from any current directory:

python3 ~/.codex/skills/markdown-new/scripts/markdown_new_fetch.py 'https://example.com'

Modes

Conversion Modes (--method)

• auto: default pipeline, fastest successful path
• ai: force Workers AI conversion path
• browser: force Browser Rendering for JS-heavy pages

Output Modes

• default: print Markdown to stdout
• --output <file>: write Markdown to file
• --deliver-md: write .md output with wrapped content; useful for reasoning LLMs on long reads because it reduces format confusion:

<url>
...markdown...
</url>

If --deliver-md is used without --output, filename is auto-generated from the URL.

How It Works

1. Validate the input URL (http/https).
2. Call POST https://markdown.new/ with url, method, and retain_images.
3. Accept response as either raw markdown or JSON with markdown in content.
4. Normalize metadata and choose output behavior.
5. Return stdout by default, --output for files, and --deliver-md for wrapped .md packets.

Install Paths

• Codex (macOS/Linux): ~/.codex/skills/markdown-new
• Claude Code (macOS/Linux): ~/.claude/skills/markdown-new

Install on macOS/Linux (single command)

Codex

mkdir -p ~/.codex/skills && rm -rf ~/.codex/skills/markdown-new && cp -R /Users/pro16/Dropbox/experiments/skills-i-use/markdown-new ~/.codex/skills/

Claude Code

mkdir -p ~/.claude/skills && rm -rf ~/.claude/skills/markdown-new && cp -R /Users/pro16/Dropbox/experiments/skills-i-use/markdown-new ~/.claude/skills/

Quick Usage

python3 scripts/markdown_new_fetch.py 'https://example.com'
python3 scripts/markdown_new_fetch.py 'https://example.com' --method browser --retain-images --output page.md
python3 scripts/markdown_new_fetch.py 'https://example.com' --deliver-md

Credits

• webservervis for the markdown conversion service powering this skill.