Open Markdown files and folders
Open local Markdown files and folders in Aero Markdown. Add a second folder, return to recent documents, and choose which files appear in the sidebar.
Read the guideTHE PRACTICAL SIDE
Read Markdown on Mac, one step at a time.
Step-by-step tutorials for reading Markdown on your Mac. From your first .md file to the documents your coding agent writes.
START HERE · 3 MIN READ
Open Markdown files and folders
Open local Markdown files and folders in Aero Markdown. Add a second folder, return to recent documents, and choose which files appear in the sidebar.
Read the tutorialFIND YOUR NEXT STEP
Explore the guides.
Pick a topic and take it one document at a time.
26 guides
How to open .md files on Mac
Choose source text, a Finder preview or a rendered page. Try a connected example folder without uploading your document.
Read the guideHow to preview Markdown in Finder
Understand macOS Quick Look, Markdown extensions and the move from a quick preview to a connected folder.
Read the guideHow to read Mermaid diagrams in Markdown
Read a Mermaid diagram beside its explanation: how a renderer draws it, how to inspect the source, and why document links differ from diagram arrows.
Read the guideHow to export a Markdown document to PDF on Mac
Export a Markdown document to PDF on your Mac, then check tables, code blocks, Mermaid diagrams, local images and links before you share the file.
Read the guideRelative Markdown links: files, headings and missing paths
Follow a specification into architecture and decisions, then diagnose missing files and heading links.
Read the guideHow to review a Markdown specification with its supporting files
A reading path for reviewing a Markdown specification together with its architecture notes and decision log, using a sample project you can download.
Read the guidePrepare a Markdown folder for offline reading
Prepare a Markdown documentation folder for offline reading: check local images, relative links and remote resources before you go off the network.
Read the guideLocal Markdown images not showing? Check the path first
Markdown images not showing on Mac? Check the relative path, file name case and folder first, then test with a minimal file and a known SVG image.
Read the guideMarkdown Quick Look not working on Mac: a safe checklist
Markdown Quick Look not working on your Mac? Check the file extension, the default app, the Quick Look extension and macOS settings before reinstalling.
Read the guideCheck a Markdown documentation folder before handoff
A manual checklist for a Markdown documentation folder before handoff: relative links, local images, source files and the exported PDF or HTML copies.
Read the guideRead a GitHub README locally with its supporting files
Read a GitHub README locally with its images and linked docs: download the repository folder, not just README.md, so relative links keep working.
Read the guideReview a Claude Code plan as a Markdown document
Review a Claude Code plan as a Markdown document before you approve it, with a fictional example plan and a human checklist for scope, risks and checks.
Read the guideRead a Cursor agent report beside your code
Keep a Cursor agent report as a local Markdown file next to your code and review it as a document, instead of treating the editor chat as the only record.
Read the guideRead AGENTS.md, CLAUDE.md and SKILL.md as documents
How to read AGENTS.md, CLAUDE.md and SKILL.md instruction files as ordinary Markdown: what they contain, how to review them, and what a reader can't do.
Read the guideSave a ChatGPT or Claude answer as Markdown
Save a useful ChatGPT or Claude response as a Markdown file you can read later, and know how that differs from a full account data export.
Read the guideRead math in Markdown on Mac without guessing the renderer
Check LaTeX math in Markdown on a Mac: inline and block delimiters, which renderers support it, and a small example file to test your viewer.
Read the guideHow to read and export wide Markdown tables
Read wide Markdown tables without losing columns: check alignment and long cells, then export to PDF without clipping. Uses a real requirements table.
Read the guideWhy a README can look different on GitHub and on your Mac
Why a README renders differently on GitHub and on your Mac: GitHub-only extensions, relative image paths and renderer differences, checked with one file.
Read the guideOrganize architecture decision records (ADRs) as linked Markdown
Keep architecture decision records as short Markdown files, with a decision index and links back to the requirement each one answers. Includes a sample folder.
Read the guideExport Markdown as HTML for a local handoff
Export Markdown as a single local HTML file, then check that it keeps its images and styles before you hand it to someone who doesn't use Markdown.
Read the guideShare Markdown as PDF or HTML with someone who doesn't use Markdown
Choose how to share a Markdown document: the source files, a single HTML file or a PDF, depending on whether the recipient needs to edit, read or print it.
Read the guideRead Obsidian Markdown files in another app
Read Obsidian Markdown files in another app: which standard links work everywhere, and how wikilinks, embeds and callouts behave outside Obsidian.
Read the guideReading controls, formats and export
Learn Aero Markdown’s reading controls, heading outline, supported formats, search, PDF and HTML export, and optional editing of the open document.
Read the guideFollow links and find your way back
Follow relative Markdown links in Aero Markdown, use back and forward, link to a heading, and understand which destinations open in the app or browser.
Read the guideRead Markdown written by coding agents
Read Markdown from coding agents on your Mac. Learn how automatic file reload and optional local hooks for Claude Code, Cursor, and Windsurf work.
Read the guide