Support
Answers to common questions about Marklet. Can't find what you need? Email us.
Getting Started
Click the Open Folder button on the welcome screen, or use File → Open Folder (⌘O). Marklet will ask you to select a folder — this grants it access to read your files. Access persists across launches, so you only need to do this once per folder.
Marklet uses macOS App Sandbox, which means it can only access folders you explicitly grant. Once you open a folder, Marklet saves a security-scoped bookmark so it can reopen it automatically on the next launch. If this isn't happening, try opening the folder again via ⌘O — the bookmark may have been cleared when the app was reinstalled.
Yes. Double-click any .md file in Finder and choose Open With → Marklet. The file opens immediately in a single-file view. You can still open a folder later from within the app to browse related files.
Reading & Navigation
Click the Table of Contents icon in the toolbar (the list icon). A popover appears listing every heading in the document — click any entry to scroll directly to that section.
Press ⌘F to open the Find bar. It works in both the rendered preview and the source view. Use the arrow buttons or Return / Shift+Return to move between matches.
Use ⌘[ (Back) and ⌘] (Forward) to move through your reading history, the same way you would in a browser.
Themes & Appearance
Click the Settings gear icon at the bottom of the sidebar. You can choose from four themes (GitHub, Sepia, Minimal, Editorial), adjust font size with the stepper, and set content width (Narrow / Medium / Wide).
Yes. Marklet follows your macOS system appearance. The sidebar and window chrome adapt automatically. The reading themes themselves are fixed — they don't invert — but you can choose whichever theme works best for you in both light and dark environments.
Editing & Export
Yes. Press ⌘U to toggle Source View, which shows the raw Markdown. Edit directly in the source view. A blue Save button appears when you have unsaved changes — press ⌘S to save. Press ⌘U again to return to the rendered preview.
With a file open, choose File → Export as HTML (⇧⌘E). Marklet saves a self-contained HTML file that includes your current theme's CSS — ready to open in any browser or share with anyone.
Files & Folders
Images must be referenced with a relative path and must be located inside the folder you opened. For example:  or . Images outside the opened folder cannot be loaded due to macOS sandboxing.
Open Settings (gear icon at the bottom of the sidebar) and enable Show Hidden Files. This reveals dot-files and folders such as .claude, .git, and others.
Click the pin icon next to the folder name at the top of the file tree. Pinned folders appear in the Pinned Folders section of the sidebar and can be switched instantly without the folder picker.
Troubleshooting
This appears when the file you were viewing has been moved, renamed, or deleted outside of Marklet. Click a different file in the sidebar to continue, or use File → Open Folder to reload the folder.
Quit Marklet, then run the following command in Terminal: defaults delete shark.marklet This clears all saved preferences, pinned folders, and favorites. The next launch will show the Welcome screen as if the app was freshly installed.
Check that syntax highlighting and Mermaid rendering are enabled in Settings. For Mermaid, make sure the code block is fenced with ```mermaid. For code blocks, a language tag after the opening fence (e.g. ```python) gives the best highlighting results.