Markdown Viewer

Choose an .md file to read it as a page.

It opens right here in your browser. Nothing is uploaded unless you choose Get a free link.

Share this page as a link

A free link lasts 4 hours and needs no account. Anyone with the link sees the page exactly as your preview shows it.

Nothing to share yet

Open a file or paste something above

Your link: untitled--••••••.pagegoat.site
Six random characters are added, so nobody can guess or take your address.

Open or paste something first · lasts 4 hours

Open an .md file or a README, or paste Markdown, and read it as a formatted page, with the # and ** marks turned into headings and bold. Tables, highlighted code, math and Mermaid diagrams render the way GitHub shows them. It all happens in your browser, and the file isn’t uploaded unless you choose Get a free link. Save it as a PDF, copy it into Google Docs or Word, or turn it into a link.

When you need a Markdown viewer

  • An AI assistant gave you a .md file. Claude, ChatGPT and coding tools like Cursor write their plans, reports and docs in Markdown. In a text editor they are hard going; here they read like a document.
  • Someone sent you notes.md and your phone shows code. Phones open Markdown as plain text. Open this page in your phone’s browser and choose the file instead.
  • You downloaded a project and want to read its README before you open an editor.
  • You are writing Markdown and want to see the result before you commit it, publish it or send it.

How to view a Markdown file online

1

Open the file

Choose it with Open file, drop it on the viewer, or paste the text into the editor. It opens as a page at once.

2

Read it, or edit it

Preview shows the page on its own. Split makes it a Markdown editor with a live preview: the page follows as you type.

3

Save it, or send it

Save it as a PDF or an HTML page, copy it into Google Docs or Word, or turn it into a link.

What this Markdown viewer renders

GitHub Flavored Markdown, the dialect READMEs and AI assistants write, plus the extras GitHub and the AI chats show on top of it.

You writeYou see
# Heading, **bold**, *italic*, - list, > quoteEverything in standard Markdown (CommonMark)
| a | b |, - [ ] task, ~~struck~~, https://…GitHub tables, task lists, strikethrough and autolinks
```pythonCode highlighted in about 40 languages
$E = mc^2$, $$ … $$, \( … \), \[ … \]Math, typeset with KaTeX
```mermaidFlowcharts, sequence and Gantt charts, and every other Mermaid diagram
> [!NOTE], > [!WARNING]GitHub’s note, tip, important, warning and caution boxes
Text[^1]Footnotes, linked both ways
--- at the top of the fileYAML front matter, shown as a table
<details>, <kbd>, <img align=…>The HTML GitHub allows. Scripts and styles are removed

What can’t show is anything the file points to that didn’t come with it. An image written as images/chart.png lives in a folder on the author’s computer or in their repository, so it is missing here, while one with a full web address loads. The same goes for links to other files in the folder.

Nothing you open is uploaded unless you choose Get a free link. The page is drawn in a sandboxed frame with its own locked-down origin, and HTML inside the Markdown is cleaned first, so a file from a stranger can’t run code here. If a document has a diagram, the library that draws it comes from a public CDN; your text stays in your browser.

Open MD files on Windows, Mac, iPhone and Android

Every device can open a .md file, but most show you the text rather than the page. This viewer works in any browser, with nothing to install.

On Windows

Notepad on Windows 11 can show basic Markdown once you switch on Formatting in its settings; older versions show the raw text. VS Code previews a file with Ctrl+Shift+V. For tables, code, math and diagrams, open this page in Edge or Chrome.

On a Mac

Finder’s Quick Look and TextEdit both show the raw text, # marks and all. VS Code previews a file with Cmd+Shift+V. Or open this page in Safari or Chrome, choose the file, and read it as a page at a comfortable width.

On iPhone or iPad

The Files app shows a .md file as plain text. Open this page in Safari, tap Choose a Markdown file, and pick the file from Files. On iOS 26 you can also import one into Notes from the Share menu.

On Android

Most Android phones open a .md file as plain text, or have no app for it. Open this page in Chrome, tap Choose a Markdown file, and pick it from Downloads or wherever your chat app saved it.

What is an .md file?

An .md file is a plain-text document written in Markdown, a way of formatting with ordinary characters: a # for a heading, ** around bold words, a - for each item in a list. John Gruber created it in 2004 so that text would read well even before it was formatted. It is now the usual format for README files, software documentation, notes apps such as Obsidian, and the answers AI assistants write. Files ending .markdown, .mdown or .mkd are the same thing.

Any text editor opens one. A Markdown viewer shows you what the marks are meant to look like: the headings, tables, lists and links the author had in mind.

Reading it is free. Sending it is where .md files fall down.

A .md file makes a poor attachment. Everyone you send it to has to find a viewer, most phones show them the raw text, and once it is sent you can’t correct it. A link has none of those problems: it opens as a formatted page on any device, and it shows the new version when you replace the file behind it.

If the document can be public, GitHub or a Gist will show it for free. Pagegoat is for the ones that shouldn’t be: put a page behind a password, limit it to people you name, or ask each reader for an email, and let them comment on the exact words they mean. Plans start at $2.99 a month. The box under the viewer makes a free link for the page you have open, or carries it into the upload for a link that lasts.

Got HTML rather than Markdown? The HTML viewer does the same job for .html files.

Markdown viewer questions

How do I open an MD file?

Open this page, then choose the file with Open file, drop it onto the viewer, or paste its text into the editor. It opens as a formatted page straight away, with headings, lists, tables, links and code the way GitHub shows them, and there is nothing to install or sign up for. Any text editor can open a .md file too, such as Notepad, TextEdit or VS Code, but there you read the raw text with its # and * marks rather than the page they describe. VS Code shows a formatted preview if you press Ctrl+Shift+V (Cmd+Shift+V on a Mac), and Notepad on Windows 11 can show basic formatting once Formatting is switched on in its settings.

Is my Markdown file uploaded or stored anywhere?

No. Your browser reads the file and draws the page inside this one. It is not sent to pagegoat or to anyone else, and nothing is kept after you close the tab, which matters when the file is a contract draft, a client report or notes an assistant wrote from your own documents. Two things can go over the network, and neither carries your text: if the document has a Mermaid diagram, the library that draws it loads from a public CDN, and an image in the file that points to a web address loads from wherever it is hosted. The document itself only leaves your browser if you choose Get a free link, which puts the page online as a short-lived public link, or the paid upload, which needs you to sign in.

How do I convert a Markdown file to PDF?

Open the file here, check the preview, then choose Save and PDF. Your browser's print window opens with the formatted page; pick Save as PDF as the destination and save. The page has its own print styles, so the PDF comes out as dark text on white even if your screen is in dark mode, and tables, code blocks, equations and diagrams are kept off page breaks where they fit on one page. The date and web address at the top and bottom of each page are your browser's headers and footers, and you can switch them off in the print window's settings for a cleaner document. Nothing is uploaded to make the PDF: your own browser writes it.

Can I open a Markdown file in Word or Google Docs?

Word opens a .md file as plain text, so you get the # and ** marks rather than headings and bold. The quick way across is to open the file here, choose Copy and then Formatted text, and paste into your document: headings, bold, lists, links, tables and code arrive as real formatting you can edit, in Word, Google Docs, Gmail or Outlook. Google Docs can also import a .md file itself through File, Open, Upload, and it can paste Markdown as formatting once Enable Markdown is ticked under Tools, Preferences. What a document can't keep is a Mermaid diagram, which word processors don't draw; save the page as a PDF if you need the diagrams too.

Why don't the images in my Markdown file show up?

Because the file points to images that didn't come with it. Markdown doesn't contain its pictures; it refers to them, and a reference like images/chart.png means a file in the folder next to the .md on the author's computer, or in their repository. This viewer only has the one file you opened, so an image referenced that way can't load, while one written with a full web address, starting https://, loads normally. It is the most common gap when you open a README on its own, away from its repository. If you wrote the document, link each image by its full web address, and the pictures will show wherever the file goes: in this viewer, on GitHub, in a PDF you make from it, or on a shared link.

Does it work as a README viewer, the way GitHub shows one?

Yes. A README is a Markdown file, and the viewer follows GitHub Flavored Markdown, the dialect READMEs are written for: tables, task lists, strikethrough, plain web addresses as links, and footnotes. It also renders what GitHub added later: alerts written > [!NOTE] or > [!WARNING], Mermaid diagrams, math between dollar signs, and front matter as a table. Headings get the ids GitHub gives them, so a README's own table of contents works, and HTML inside it renders the way GitHub allows, so details, kbd and centred logos work while scripts and styles are removed. The styling is GitHub's, light or dark to match your system. The one gap is anything that points to another file in the repository, such as an image at images/logo.png, because only the README came with you.

Which math and diagram syntax does it support?

Math is LaTeX, typeset with KaTeX. Put it between single dollar signs for math inside a sentence and between double dollar signs for an equation on its own line, which is how GitHub, Obsidian and Claude write it. ChatGPT writes \( … \) and \[ … \] instead, and those work too, so an answer copied out of ChatGPT renders without edits, while prices such as $20 stay as text. Diagrams are Mermaid: a code block that opens with ```mermaid becomes a flowchart, sequence diagram, Gantt chart, class, state or ER diagram, pie chart, mind map or any other type Mermaid draws. A diagram with a mistake in it shows the error above its source, so you can fix it in the editor and watch it redraw.

Is it safe to open a Markdown file someone sent me?

Yes, more than most formats. A .md file is plain text and can't run anything by itself. The risk is HTML written inside it, and the viewer removes the dangerous parts before showing it: scripts, styles, forms, embedded frames and handlers such as onclick. What is left is shown inside a sandboxed frame with its own locked-down origin, so even a bug in a library couldn't reach this site's cookies or storage. A document can still contain a link to a bad website, or an image from a server that notices you opened it, the same as an email can. Read it freely, but think twice before following a link or typing a password anywhere it sends you.

How do I open a Markdown file from Claude or ChatGPT?

Download the file the assistant made and open it here, or copy the answer and paste it into the editor; the copy button under a reply in Claude or ChatGPT gives you Markdown. Either way it renders as a page, with headings, tables, highlighted code, math and Mermaid diagrams included. From there you can read it at a comfortable width, save it as a PDF, copy it as formatted text into Google Docs or Word, or download it as an .html page that opens in any browser. If what the assistant gave you is HTML or a React artifact rather than Markdown, the HTML viewer and the Claude artifact viewer on this site do the same job for those.

How do I share a Markdown file so it opens as a formatted page?

Send a link instead of the file. A .md attachment makes everyone you send it to find a viewer, and on a phone most of them will see the raw text. A link opens as a formatted page on any device, and it shows the latest version when you replace the file behind it. If the document can be public, GitHub and GitHub Gist render Markdown for free. Pagegoat is for the documents that shouldn't be public: put one behind a password, limit it to people you name, or ask each reader for their email, and let them comment on the exact sentence they mean. For a page someone only needs today, Get a free link under the viewer makes a short-lived public link with no account. Links that last start at $2.99 a month.