MarkPane — Support

MarkPane accepts readable local text files, including .md, .markdown, .mdown, .mkd, and .txt. If the file is not readable text, or if macOS cannot grant access to it, MarkPane shows an error. Try moving the file to a normal local folder and opening it again.

Choose a normal local folder when prompted. MarkPane uses macOS folder permission to show the folder tree and open supported Markdown files inside it. Hidden files and package contents are skipped, and non-Markdown files may appear dimmed for context.

Choose a writable local folder when the save panel opens, or use Create New Markdown inside a writable folder in the Folder Access window. MarkPane creates .md, .markdown, .mdown, .mkd, or .txt files. If the folder is read-only, outside the folder access you granted, or already contains an item with the same name, MarkPane shows an error.

Use Create New Folder from the Folder Actions menu or from a folder context menu in the Folder Access window. MarkPane creates a writable folder named Untitled Folder, or the next available numbered name, then starts inline rename. If the parent folder is read-only, outside the folder access you granted, or blocked by macOS permissions, MarkPane shows an error.

Use the context menu in the Folder Access window and choose Rename. Names cannot be empty, contain /, or match another item in the same folder. If macOS does not allow the move, try a normal writable local folder.

Use the context menu in the Folder Access window and choose Delete. MarkPane asks for confirmation, then moves the selected item to the macOS Trash. If macOS does not allow the move, try a normal writable local folder or adjust the file's permissions in Finder.

If a rendered link points to another local Markdown file outside the folder access MarkPane already has, choose the linked file's folder when prompted. MarkPane then opens the linked document in a tab.

Because MarkPane is sandboxed, images stored next to a Markdown file may require explicit folder access. Use the inline Allow Local Images action and select the Markdown file's folder when prompted.

MarkPane updates task markers such as [ ] and [x] directly in the Markdown file. The file must still be writable, and the rendered checkbox must match a task marker in the source. If the source changed outside MarkPane, reopen the file and try again.

Open a Markdown file first. The source editor is available for file-backed documents, and changes autosave back to that file.

This is expected. MarkPane avoids Markdown list continuation inside fenced code blocks so code samples stay plain while editing.

Find in Markdown searches the rendered document, including headings, tables, code, math fallback text, details, and footnotes. It does not behave like a raw-source text search.

Confirm that the diagram is inside a fenced code block labeled mermaid. MarkPane supports flowchart, state, sequence, class, ER, and XY chart Mermaid fences. Other diagram types or unsupported Mermaid syntax may fail to render.

Display math is supported with $$...$$, \[...\], and fenced math blocks. Some complex or invalid TeX may be shown as readable fallback text if MathJax cannot render it.

Use View > Window Transparency to choose a different opacity, or toggle View > Use Glass Document Surface. The exact appearance can vary by macOS version and system appearance.

Very large Markdown files, complex diagrams, or large math sections may take a moment to parse and render. If a document feels slow, try reducing very large generated tables or splitting the file into smaller documents.