mdxgists.net

GitHub Gists are the fastest way to share code, notes, and snippets. But they look terrible. This fixes that.

How it works

Take any GitHub Gist URL and replace gist.github.com with mdxgists.net. That's it.

gist.github.commdxgists.net

See the difference:

GitHub Gist
All gists
user/SKILL.mdSecret
Created 2 hours ago
CodeRevisions 1
mdxgists.net showcase
example.pyRaw
1"""
2Minimal gist fetcher.
3"""
4 
5import httpx
6from dataclasses import dataclass
7 
8@dataclass
9class GistFile:
10 filename: str

mdxgists.net showcase

mdxgists.net

A beautiful viewer for GitHub Gists. Replace gist.github.com with mdxgists.net in any URL.

TIP

You're looking at a mdxgists.net page right now. Try switching between the file tabs above.

Customize it

mdxgists.net/linuz90/55a...2fe

Append URL params to any gist link to customize how it looks.

?theme dark or light mode
?noheader Hide title, tabs, and copy buttons
?nofooter Hide author info and footer
?mono Monospace font for all text

Agent skill

Install our share-pretty-gist skill to teach your AI agents to share beautiful gists whenever you need to share notes, code, reports, or anything else.

Or just prompt it

No skill needed. Copy this into your agent's instructions (OpenClaw, Claude Code, Cursor, etc.) and it will use mdxgists.net automatically.

When sharing code, notes, or snippets via GitHub Gists, always share the mdxgists.net link instead of the gist.github.com URL. Just replace "gist.github.com" with "mdxgists.net" in the URL. Always create secret gists (never --public unless explicitly asked). Use `gh gist create <files> -d "descriptive title"`. The -d description becomes the page title on mdxgists.net, so make it clear and useful. Use correct filenames with proper extensions (e.g. server.ts, config.yml, query.sql) so syntax highlighting works. For markdown content, use a .md file. After creating a new gist, fetch the mdxgists.net URL once (e.g. curl) to warm the cache so the page loads instantly for the reader. After updating an existing gist, POST to mdxgists.net/{user}/{gist_id}/refresh to bust the stale cache, then fetch the mdxgists.net URL to warm it with the updated content. Example: mdxgists.net/user/gist_id

Why this exists

I use gists every day to share documents, research, and snippets with teammates and friends. I also often have my AI agents create gists to share things with me.

Gists are incredibly convenient, but not particularly nice to look at. I built this for those who, like me, would rather see a clean, minimal page, even if just for 10 seconds.

Open source

mdxgists.net is fully open source. Gist pages have zero tracking or analytics. The only analytics run on this landing page via Vercel to count visitors. Your gists are fetched directly from the GitHub API and never stored. Secret gists are marked as noindex so search engines won't crawl them.

View source