MD Reader

MD Reader Support

For macOS 14 and later · English; 简体中文 available in version 1.3

Open Markdown files in tabs. Switch to Edit for source and live preview. The Help menu in the app includes the user guide, privacy policy and acknowledgements.

Common questions

How do I open files or make MD Reader the default?

Use File > Open, drag Markdown files into the window, or choose MD Reader from Finder’s Open With menu. To set it as the default, select a Markdown file in Finder, open Get Info, choose MD Reader under Open With, then select Change All.

How do I edit and navigate the preview?

Choose Edit to show the source on the left and preview on the right. In Edit mode, double-click a preview block or source line to locate the corresponding position. Drag the divider to resize the panes, or double-click it to reset their proportions.

Why are local images missing?

Choose Allow local images and grant the document’s folder or repository root. Image paths must remain inside the selected folder. PNG, JPEG, GIF, WebP and AVIF are supported up to 10 MB per image. In version 1.3 and later, access bookmarks restore with open tabs and are removed from the session when you close a tab. Earlier versions retain folder access for the current launch.

Can I disable remote images?

Turn off View > Load Remote Images. This affects future rendering and requests; requests already sent cannot be recalled.

What if the document changed elsewhere?

Save asks before replacing external changes. Use Save As to keep a separate copy. Hard-linked documents require Save As.

How does recovery work?

Version 1.3 and later restore open tabs, saved and unsaved text, tab order, reading/editing mode and your position after quitting. Explicitly close a tab to remove it from the next session; closing an edited tab still asks whether to save or discard. Original files are only changed when you save. Older recovery copies can still be inspected with Recover, retained with Later, or removed with Discard Copies.

What is new in version 1.3?

Recent files (last 30), persistent tabs and unsaved work, a collapsible table of contents, syntax highlighting and code copy, local KaTeX math and Mermaid diagrams, light paginated PDF export, and a Simplified Chinese interface. Use View > Language to choose your interface language. Export PDF with Command-Shift-P; show the outline with Command-Option-T. Availability depends on the version installed from the App Store.

Get support

Report a problem, ask a question, or suggest an improvement through the support tracker. Include the app version, macOS version, steps, expected result and actual result.

Reports are public. Remove private document content, personal information and sensitive screenshots before posting. A GitHub account is needed to submit a report.

Open support tracker

中文帮助

MD Reader 支持通过 Finder、打开对话框或拖入文件来打开 Markdown,多个文件会显示为标签页。Edit 模式左侧编辑源码、右侧实时预览。浅色、深色和跟随系统外观可在应用中选择。

如需帮助,请通过上方反馈入口提交问题,并注明应用版本、macOS 版本和复现步骤。反馈内容公开,请先移除私人文档、个人信息和敏感截图。