Swap inline links (text)(url) ↔ reference style [text][1]. Cleans long documents.
Free Markdown Reference Link Converter swaps inline Markdown links like [text](url) into reference style [text][1] with a definitions block at the bottom — and the other way around. Three label styles (numeric, slug, letters), optional starting number, and automatic URL de-duplication.
Privacy: This tool runs entirely in your browser. Your text is never uploaded, logged, or cached. Close the tab and it's gone. Verify in DevTools → Network: zero requests fire.
Long documents with many repeated URLs become much more readable when links move to the bottom. Hand-converting is tedious. The converter runs 100% in your browser.
| Input | Output | Typical size | Speed | Login needed |
|---|---|---|---|---|
| Markdown (.md) with links | Markdown (.md) with converted links | Any document size | < 20 ms | No |
Here's what this free tool does in detail — every feature is built to solve real problems, runs entirely in your browser, and is free forever.
Switch with a single radio toggle between Inline → Reference (rewrites [text](url) as [text][1] plus definitions at the bottom) and Reference → Inline (expands [text][1] back to [text](url) and removes the definitions block). Both directions preserve link titles, alt attributes, and anchor text.
For other link manipulation, try the Free Markdown Link Extractor.
Pick the label format that suits your document. Numeric ([1], [2]) is compact and standard — best for short docs or when you want consistent 2-character labels. Slug ([cloudflare-workers]) makes the labels readable so reviewers can follow references inline. Letters ([a], [b]) gives you a distinctive alternate style for documents that also have numbered footnotes.
If your document uses the same URL in multiple inline links (say, three references to https://example.com/docs), the converter writes one reference definition and points every link at the same label. This keeps the definitions block tidy and makes it easy to update a URL in one place later.
To audit which URLs appear, first run the doc through the Free Markdown Link Extractor.
Set the Start at value to a non-1 number when you're appending converted text to an existing document that already has reference definitions. The converter counts upward from there so new references don't collide with old ones.
Once your links are in reference style, format the whole document with the Free Markdown Formatter.
Inline → Reference to clean up a long doc. Reference → Inline to expand a reference-style one.
Drop in a document with links to convert.
Paste into your editor or repo.
Move inline links to reference style so prose flows without visual noise.
Convert footnote-style citations to reference links for easier review.
Flip a doc to inline style temporarily to see URLs in context, then flip it back before publishing.
Use reference links for repeated URLs (like the docs site) so they're easy to update in one place.
Keep paragraphs readable by moving 20+ URLs to a references block at the bottom.
Yes. Free forever, no account required.
A link like [text][1] with a separate definition [1]: https://example.com 'title' at the bottom of the document.
Yes. The same URL reuses a single definition, and every link points to it.
Yes. Convert inline → reference → inline and the result is equivalent to the original.
No. Runs 100% in your browser.