Markdown Url
- 1.2k installs
- 1k repo stars
- Updated July 14, 2026
- am-will/codex-skills
markdown-url is an agent skill for route any website you need to visit through markdown.new by prefixing the url.
About
The markdown-url skill is designed for route any website you need to visit through markdown.new by prefixing the URL. markdown.new URL Prefix Whenever you need to visit a website URL, you must: 1) rewrite it to go through https://markdown.new/, then 2) visit the rewritten URL, and 3) pull the Markdown content from that page for use in your answer/notes. Normalize the destination into an absolute URL with a scheme (https:// preferred). Invoke when the user asks about markdown url or related SKILL.md workflows.
- https://example.com -> https://markdown.new/https://example.com.
- https://example.com/docs?a=1#b -> https://markdown.new/https://example.com/docs?a=1#b.
- example.com -> https://markdown.new/https://example.com.
- Documentation pages.
- Blog posts / announcements / changelogs.
Markdown Url by the numbers
- 1,161 all-time installs (skills.sh)
- Ranked #59 of 735 Git & Pull Requests skills by installs in the Skillselion catalog
- Security screen: HIGH risk (skills.sh audit)
- Data as of Aug 3, 2026 (Skillselion catalog sync)
markdown-url capabilities & compatibility
- Capabilities
- https://example.com > https://markdown.new/http · https://example.com/docs?a=1#b > https://markdo · example.com > https://markdown.new/https://exam · documentation pages
What markdown-url says it does
Route any website you need to visit through markdown.new by prefixing the URL.
Route any website you need to visit through markdown.new by prefixing the URL.
npx skills add https://github.com/am-will/codex-skills --skill markdown-urlAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 1.2k |
|---|---|
| repo stars | ★ 1k |
| Security audit | 2 / 3 scanners passed |
| Last updated | July 14, 2026 |
| Repository | am-will/codex-skills ↗ |
How do I route any website you need to visit through markdown.new by prefixing the url?
Route any website you need to visit through markdown.new by prefixing the URL.
Who is it for?
Developers using markdown url workflows documented in SKILL.md.
Skip if: Skip when the task falls outside markdown-url scope or needs a different stack.
When should I use this skill?
User asks about markdown url or related SKILL.md workflows.
What you get
Completed markdown-url workflow with documented commands, files, and expected deliverables.
- markdown.new URLs
- Normalized absolute https links
Files
markdown.new URL Prefix
Whenever you need to visit a website URL, you must: 1) rewrite it to go through https://markdown.new/, then 2) visit the rewritten URL, and 3) pull the Markdown content from that page for use in your answer/notes.
Rewrite Rule
1. Normalize the destination into an absolute URL with a scheme (https:// preferred). 2. Prefix it with https://markdown.new/ (do not drop the original scheme).
Examples
https://example.com->https://markdown.new/https://example.comhttps://example.com/docs?a=1#b->https://markdown.new/https://example.com/docs?a=1#bexample.com->https://markdown.new/https://example.com
Agent Workflow (Required)
When you would normally open a website to read it:
1. Produce the rewritten markdown.new URL. 2. Visit the rewritten URL first (not the original), but only when it is likely to work (see Policy below). 3. Extract the page content from the Markdown view (the rendered Markdown and/or the raw Markdown). 4. Use that extracted Markdown as the source for summaries, quotes, checklists, or copy/pasteable notes.
If the markdown.new view fails to load or breaks critical functionality, fall back to the original URL for browsing, but still prefer markdown.new for any content extraction if possible.
Policy: When To Use markdown.new (Required)
Do NOT route every site through markdown.new. Use it primarily for "read-only" pages where you want clean, extractable text:
- Documentation pages
- Blog posts / announcements / changelogs
- GitHub issues/PR discussions (when you just need readable text)
- Articles and guides
Skip markdown.new and go straight to the original URL when the destination is likely to be blocked or requires the original site behavior:
- Login, OAuth, checkout, payment, or any authenticated workflow
- Sites that gate content behind JS apps, CAPTCHAs, bot detection, or paywalls
- File uploads, forms, editors, dashboards, interactive widgets
- Anything where cookies/session state must be preserved
Block/Failure Signals (Treat As Blocked)
If you try markdown.new and see any of the below, stop retrying and fall back to the original URL:
- HTTP
401/403/429, "Access denied", "Forbidden", "rate limited" - CAPTCHA / "verify you are human"
- Empty/partial content that clearly does not match the page
- Redirect loops or repeated navigation failures
Fallback Behavior
1. Attempt markdown.new once when appropriate. 2. On block/failure, immediately switch to the original URL for browsing. 3. If you still need extractable text, try to extract from the original page (reader mode / copy text) and clearly note that markdown.new was blocked.
Notes / Exceptions
- Keep this for reading/browsing. For API endpoints, OAuth flows, file uploads, or anything that depends on cookies/login state, use the original URL if the proxy breaks functionality.
- Do not rewrite local paths (
./README.md) or non-HTTP(S) schemes.
Optional CLI Helper
Convert a URL into its markdown.new-prefixed form:
node skills/markdown-url/scripts/markdown-url.js "https://example.com/docs"#!/usr/bin/env node
'use strict';
function normalizeToAbsoluteUrl(input) {
const s = String(input || '').trim();
if (!s) return null;
// If it already looks like http(s), keep it as-is.
if (/^https?:\/\//i.test(s)) return s;
// Reject other schemes (mailto:, file:, etc).
if (/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(s)) return null;
// Treat bare hosts/paths as https.
return 'https://' + s;
}
function toMarkdownNewUrl(input) {
const abs = normalizeToAbsoluteUrl(input);
if (!abs) return null;
return 'https://markdown.new/' + abs;
}
const input = process.argv.slice(2).join(' ');
const out = toMarkdownNewUrl(input);
if (!out) {
process.stderr.write('Usage: markdown-url <http(s)://url | host/path>\\n');
process.exit(2);
}
process.stdout.write(out + '\n');
Related skills
Caveman CommitGenerate terse, Conventional Commits messages that preserve intent without fluff or AI attribution.272k94k
Resolving Merge ConflictsQuickly understand, resolve, and commit merge conflicts without losing work or breaking their flow.183k193kGit Guardrails Claude CodePrevent Claude Code from accidentally running destructive git commands like force push, hard reset, or clean.175k193k
Using Git WorktreesGuarantee every new feature or implementation task runs inside a clean, isolated workspace without polluting the main branch or current working directory.149k263k
Git CommitGenerate accurate conventional commit messages and intelligently stage files directly from natural language requests.40.6k37.2k
Resolve Merge ConflictsQuickly understand and resolve Git merge conflicts without losing context or breaking changes.16.5k148How it compares
Use markdown-url for quick markdown.new link generation instead of heavier browser scraping when clean readable Markdown is enough.
FAQ
What does markdown-url do?
Route any website you need to visit through markdown.new by prefixing the URL.
When should I use markdown-url?
User asks about markdown url or related SKILL.md workflows.
Is markdown-url safe to install?
Review the Security Audits panel on this page before installing in production.