How to Open and Edit a Markdown File on iPhone
Short answer: to read or edit a Markdown (.md) file on an iPhone, open it from the Files app in a Markdown reader. iOS has no built-in renderer for .md, so without one you only see raw symbols like # and **. Markdown Reader & Editor - MD is a free-to-download app that renders the file, lets you edit it with a live preview, and works offline with no account.
Why a .md file looks broken on iPhone
A Markdown file is plain text. The headings, lists, tables and code blocks only appear when an app interprets the symbols. Files and Mail show the raw text, which is why a README opened from GitHub or a note exported from another app looks messy.
How to open a Markdown file on iPhone or iPad
- Install a Markdown reader from the App Store.
- In Files, iCloud Drive, Mail or any app's share sheet, tap the
.mdfile. - Choose the reader (or use Share, then "Copy to" the app).
- The file opens rendered, with headings, tables and highlighted code blocks.
What to look for in a Markdown app
- Renders instantly from Files and iCloud Drive, not only from an in-app import.
- Live side-by-side preview while you type.
- Works offline, so notes never depend on a sync service.
- Tables, task lists and fenced code blocks with syntax highlighting.
- PDF export, for sharing a document with someone who does not use Markdown.
- Mermaid diagrams, if you write documentation with flowcharts or sequence diagrams.
- Dark mode and editor themes for reading comfort.
Markdown Reader & Editor - MD covers each of these. It also has find and replace, undo/redo, line numbers, a quick-insert toolbar for headings, bold, lists, links, tables and checkboxes, and themes including Dracula, Monokai, Nord and Solarized.
Frequently asked questions
Is there a free Markdown reader for iPhone? Yes. Markdown Reader & Editor - MD is free to download, and the core reading and editing needs no account.
Can I edit Markdown on iPad as well? Yes. The same app runs on iPhone and iPad.
Can I turn a Markdown file into a PDF on iPhone? Yes. Open the file and use Export to PDF.
Does it support Mermaid diagrams? Yes. You can write flowcharts, sequence diagrams, class diagrams and Gantt charts in plain text and see the diagram update as you type.
Do my notes leave my phone? No sync account is required, and the app works fully offline.
Download Markdown Reader & Editor - MD on the App Store
On Android: Markdown Reader & Editor on Google Play. Free to download, same features, works offline.