Index of every page on this site: llms.txt
All skills
am-will avatar

/markdown-url

@9f954c3
by am.willam-will/codex-skills1k stars
60
Run it yourself

Route any website you need to visit through markdown.new by prefixing the URL. **WHEN TO USE:** - You would normally open a website link to read content (docs, blog posts, changelogs, GitHub issues, etc.) - You need a cleaner, Markdown-friendly view for copying notes or summarizing

  • 2 files
  • 4.2 KB
  • Updated 9 months ago
  • GitHub
Use this Skill: https://skilld.dev/gh/am-will/codex-skills/markdown-url

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈74 tokens for metadata: the name and description. ≈785 when used: this file.

Description uses 3.7% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈298 characters, or 3.7%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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.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

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"

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at 9f954c3. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last month.

Steadyupdated 9 months ago
  • Documentation
  • markdown
  • url-rewriting
  • content-extraction
  • web-browsing
  • readability

README badge

README badge for am-will/codex-skills/markdown-url

Rewrites any website URL to route through markdown.new for clean, text-extractable Markdown views of documentation, blog posts, changelogs, and GitHub issues. The skill includes policy rules to skip markdown.new for authenticated workflows, interactive content, and paywalled sites, with fallback to the original URL on block or failure.

Generated from the current SKILL.md.

When should I use markdown.new instead of visiting the original URL?
Use markdown.new for read-only pages like documentation, blog posts, changelogs, and GitHub issues where you need clean, extractable text. Skip it for authenticated workflows, login pages, paywalled content, or interactive features that require the original site behavior.
What do I do if markdown.new fails to load or returns an error?
If you encounter HTTP 401/403/429, CAPTCHAs, empty content, or redirect loops, immediately fall back to the original URL. Try to extract text from the original page directly if you still need content.
How do I rewrite a URL to use markdown.new?
Prefix the absolute URL with `https://markdown.new/`. For example, `https://example.com/docs` becomes `https://markdown.new/https://example.com/docs`. Keep the original scheme and all query parameters and fragments.
Does this work with local file paths or non-HTTP URLs?
No. Do not rewrite local paths like `./README.md` or non-HTTP(S) schemes. Use markdown.new only for absolute URLs with http or https.

Generated from the current SKILL.md. These answers refresh after source changes.