Markdown sharing guides / Pass a Markdown URL to AI

How to pass a Markdown share URL to AI

markdown.bz share pages provide both HTML for people to read and raw Markdown that is easy for AI to fetch. However, passing a URL does not guarantee that every AI can actually access external pages.

Can AI tell from the share URL alone?

If the AI can actually access the share URL, it can discover where the raw Markdown is. The share page's HTTP headers and HTML point to the text/markdown version. On the other hand, if the AI you are using has no browsing feature, has external access turned off, or is restricted in what it can access, it cannot read the page.

1. How share pages announce the raw Markdown

When the regular share URL is accessed, the raw Markdown can be found in three ways:

The HTTP Link header announces the Markdown version with rel="alternate"
The HTML announces it with <link rel="alternate" type="text/markdown">
The Raw Markdown link on the page goes straight to it

Link: </d/SHARE_ID/raw>; rel="alternate"; type="text/markdown"

2. Use /raw to point to the raw Markdown reliably

Add /raw to the end of the share URL and pass that to the AI.

https://markdown.bz/d/SHARE_ID/raw

Instead of styled HTML, this URL returns the original Markdown text with Content-Type: text/markdown; charset=utf-8. For tasks where you want the AI to read the Markdown syntax as is, such as summaries, reviews or structured extraction, /raw leaves no ambiguity.

3. Give the URL together with the task

Read the raw Markdown below and summarize it, keeping the key points and the open issues separate.
https://markdown.bz/d/SHARE_ID/raw

Do not add anything that is not in the original; list any unknowns as open questions instead.

Rather than just saying "read this", spell out the output format, that it must not fill in anything missing from the original, and the points you want checked. Before using what the AI retrieved for important decisions, compare it with the original.

4. Check from the command line that it can be fetched

curl --fail --location \
  'https://markdown.bz/d/SHARE_ID/raw'

If the Markdown text comes back, everything is ready on the publishing side. To check only the pointer on the regular page, run curl -I https://markdown.bz/d/SHARE_ID and look at the Link header.

5. What to check if AI cannot read it

Situation	What to do
The AI has no web access	Paste the Markdown text directly, or attach it as a file
Password-protected	The AI does not have the unlock cookie, so as a rule it cannot fetch the raw Markdown
Expired or deleted	Create a new share URL
Organization network restrictions	Ask your administrator whether HTTPS access to `markdown.bz` is allowed
Unclear what the AI fetched	Have the AI show the headings or opening lines it read, and compare them with the original

Do not include personal information, confidential information or credentials in documents you pass to AI, either. Share pages are not indexed by search engines by default, but that does not stop people who know the URL from viewing them.

Create a Markdown URL for AI

Last reviewed: August 3, 2026 / Reviewed by the markdown.bz team