A quick guide

How to open an MD file

An .md file is a plain-text document written in Markdown. A reader turns its heading markers, lists and tables into a formatted page. You can read one here without installing an app or creating an account.

Open your Markdown file

On Mac or Windows

  1. Open Markdown Viewer in your browser.
  2. Select Choose a file and pick your .md file, or drag the file into the large opening area.
  3. Read the formatted document. Use the contents list to jump to a section.

Local files are read in your browser. The app does not upload the document or its filename. You can keep the original file wherever you normally save your notes.

On your phone

Open the reader, tap Choose a file and select a saved Markdown file using your phone’s file picker. The On this page menu opens the section list. If you have the text rather than a file, use Paste Markdown instead.

If an AI gave you Markdown

Copy the Markdown text, choose Paste Markdown, then select Read document. Pasted text stays in your browser too. If the AI included an outer code fence just to wrap its answer, copy the document inside that fence.

An agent with HTTP access can also create a ready-to-open link using our agent instructions. That is a different data flow: the API receives the text, and the returned link contains the document. Anyone with that link can read it.

Why does my file show hashes and asterisks?

A text editor shows the Markdown source. For example, # Heading becomes a heading and **important** becomes bold text in a reader. Seeing these characters does not mean the file is broken. Renaming the file to .pdf will not convert it.

What works here?

Headings, paragraphs, lists, task lists, tables, links and code. Local files and pasted text can be up to 256 KiB; agent handoffs support 12 KiB. Supported file extensions are .md, .markdown and .txt, saved as UTF-8.

Images and raw HTML are disabled. Relative file links, diagrams and math notation are not rendered. This is a reader; use a text editor to change the source. Reloading clears locally opened text, so keep your original file.

Try the reader · How privacy works