Why phones can't open .md files by default
Android itself doesn't recognize the .md extension and has no default app to render it. When you tap the file, it either says no app can open it or opens as plain text full of symbols. The fix is to install an app that can render Markdown, or use an online tool.
Option 1: Install a dedicated Markdown reader (recommended)
The most hassle-free way is to install an Android Markdown viewer, such as mdview for Android. Once installed:
- In your file manager, tap any .md file and choose to open it with mdview to see the formatted content;
- The system will remember, so next time it opens directly with mdview;
- For .md files received in chat apps, choose "Open with other app" → mdview.
mdview's Android package is tiny (about 500KB), doesn't use the internet, doesn't request unnecessary permissions, and renders files locally for privacy. Great for anyone who reads documents on their phone often.
Option 2: Use an online Markdown preview
If you don't want to install an app, open an online Markdown preview site in your phone browser and copy-paste the file content.
- Pros: zero installation, convenient for temporary viewing;
- Cons: switching back and forth between apps to copy-paste is tedious on mobile; local images won't display; content is pasted to a third-party site.
Suitable for occasional, non-sensitive files.
Option 3: Open with a note-taking app
If you already have note apps like Obsidian, Joplin, or similar on your phone, most can import and render .md files.
- Pros: feature-rich, good for integrating documents into your own note system;
- Cons: you need to "import" the file into the app's vault first, which is more steps and overkill for a temporary document.
Comparison of the three options
| Option | Install needed | Steps | Local images | Privacy |
|---|---|---|---|---|
| mdview or similar app | Yes | Fewest | ✓ Supported | Local render |
| Online preview | No | More (copy-paste) | ✕ | Upload to third party |
| Note app | Yes | Import required | Depends | Mostly local |
Tips for reading Markdown on your phone
- Use the outline: for long documents, check the table of contents first and tap headings to jump, faster than scrolling;
- Rotate for tables: documents with wide tables display better in landscape;
- Adjust font size: phone screens are small, a slightly larger font is more comfortable to read, and good viewers support zoom.
Final thoughts
Reading Markdown on a phone essentially comes down to having a light, fast renderer that can open files directly. If you do this often, installing a dedicated app like mdview is much better than copy-pasting into a browser. mdview's Windows and Android versions also share a consistent reading experience, so you can start reading on your computer and pick up on your phone.
Download tip: The Android APK is about 500KB and requires Android 7.0 or above. Download from the official page; if you see an "unknown source" prompt, allow installation in system settings.