Markdown.new Skill
Low
by joelchance | Audited: 2026-02-26T09:59:20.936Z | Ruleset: 0.2.0
About This Skill
Use this skill to convert public URLs into LLM-ready Markdown via markdown.new.
✨ Resolve relative paths like
scripts/... and references/... from the skill directory, not workspace root. ✨ If current directory is unknown, use an absolute script path.
✨
auto: default. Let markdown.new use its fastest successful pipeline. ✨
ai: force Workers AI HTML-to-Markdown conversion. ✨
browser: force headless browser rendering for JS-heavy pages. ✨ Use
--deliver-md to force file output in .md format. Use Cases
Documentation (Original)
Source: README.md The following is the author's original documentation (often English). For installation, follow “Quick Install” above.
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.pyare relative to the skill directory. - Do not run
python3 scripts/markdown_new_fetch.py ...from workspace root unlessscripts/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 pathai: force Workers AI conversion pathbrowser: force Browser Rendering for JS-heavy pages
Output Modes
- default: print Markdown to stdout
--output <file>: write Markdown to file--deliver-md: write.mdoutput 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
- Validate the input URL (
http/https). - Call
POST https://markdown.new/withurl,method, andretain_images. - Accept response as either raw markdown or JSON with markdown in
content. - Normalize metadata and choose output behavior.
- Return stdout by default,
--outputfor files, and--deliver-mdfor wrapped.mdpackets.
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
webservervisfor the markdown conversion service powering this skill.
Security Audit
Low
Summary
Convert public web pages into clean Markdown with markdown.new for AI workflows. Use when tasks require URL-to-Markdown conversion for summarization, RAG ing...
Risk Profile
ToxicSkills Analysis
Blocklist
Not matched
Prompt Injection
Not detected
Toxic Flags
exfiltration
No Toxic signals detected by current static checks.
Key Risks 0 items
No LLM risk bullets (LLM disabled or not cached).
Deterministic Findings (Evidence)
| Rule | Severity | File | Snippet |
|---|---|---|---|
| NET_HTTP_REQUEST | medium | skills/joelchance/markdown-convert/scripts/markdown_new_fetch.py Line 10 | import urllib.request |
| NET_HTTP_REQUEST | medium | skills/joelchance/markdown-convert/scripts/markdown_new_fetch.py Line 71 | def build_request(api_url: str, payload: Dict[str, object]) -> urllib.request.Request: |
| NET_HTTP_REQUEST | medium | skills/joelchance/markdown-convert/scripts/markdown_new_fetch.py Line 73 | return urllib.request.Request( |
| NET_HTTP_REQUEST | medium | skills/joelchance/markdown-convert/scripts/markdown_new_fetch.py Line 185 | with urllib.request.urlopen(req, timeout=args.timeout) as resp: |
| QUALITY_README_PRESENT | low | README Line n/a | README detected |
Scoring Criteria
Each skill is scored across 5 dimensions. The weighted total determines the star rating.
Code Toxicity 100/100 (weight 30%)
Privacy Risk 52/100 (weight 25%)
Permission Scope 90/100 (weight 20%)
Author Reputation 75/100 (weight 15%)
Code Quality 78/100 (weight 10%)
Star Rating Scale
5★ Safe — Score ≥ 80
4★ Good — Score 70–79
3★ Caution — Score 60–69
2★ Risky — Score 40–59
1★ Dangerous — Score < 40
Why This Score?
The following dimensions scored below 60, dragging the overall rating down:
- Privacy Risk: 52/100