Single file reading
Open a standalone Markdown file and use find-in-document, headings, and rendering controls without extra workspace setup.
How to open Markdown files on Mac.
The cleanest way to open Markdown files on Mac is with a dedicated Markdown viewer that handles local .md files, README documents, and linked docs folders without dropping you into edit mode. Vanilla Markdown is built for exactly that: open the file, render GitHub Flavored Markdown correctly, move through headings and links, and keep reading without the editor circus showing up uninvited.
If the document already exists and you only need to read it, a viewer saves a surprising amount of friction. Vanilla is designed around that exact moment.
Best for
- Opening local Markdown files from Finder and reading them immediately
- Handling README files and docs without entering edit mode
- People who want Markdown rendering plus navigation, not writing tools
Not for
- Editing Markdown content in the same app
- Collaborative publishing workflows
- Users looking for a note-taking database or sync layer
What you can throw at it
Markdown, README files, plain text, the usual suspects.
- .md
- .markdown
- .mdown
- Plain text files
- Folder trees with nested Markdown docs
If the document links to other files or sections, Vanilla resolves those links so moving through a local docs tree stays fast and predictable.
Folder-based reading
Open a saved folder tree when your docs span multiple files, such as README, setup, architecture, and API reference documents.
GitHub-style output
Keep tables, task lists, autolinks, code fences, and strikethrough readable when you are reviewing technical docs locally.
Local navigation
Use table of contents jumps, links, and back and forward history so one file can lead naturally into the rest of the documentation set.
More scoops
Keep the spoon moving
Markdown viewer for Mac
See the broader product positioning for Mac-specific reading workflows.
README viewer for local docs
Go deeper on README files, docs folders, and linked documentation trees.
Viewer vs editor
Understand why opening a file to read is a separate job from editing it.
Marked 2 alternative
Compare direct file opening with a preview companion that expects another editor.
One last scoop
Open the file. Keep your hands out of edit mode.
Vanilla gives you the viewer workflow directly: local files, proper rendering, clear navigation, and zero need to pretend reading is the same task as editing.