← Nota6

Support

For version 1.6.1

Get in touch

Email: okok.galagala@gmail.com

Issues / suggestions: GitHub issues

System requirements

Common questions

Why doesn't Nota6 let me edit?

By design. Nota6 is a Markdown reader. Use your IDE or a dedicated editor (Typora, iA Writer, Obsidian) to write Markdown, and use Nota6 to read it.

What's in the built-in Library?

12 curated documents (English + Simplified Chinese, all offline) available the moment you open Nota6: Markdown / GFM syntax references, Mermaid Diagram Gallery (10 types), KaTeX Math Reference, Code Highlighting Gallery, Reading AI-Generated Markdown, CLAUDE.md / AGENTS.md spec, README / Design Doc patterns, Nota6 Tips, iPad Keyboard Shortcuts, Themes Showcase. Tap Browse Library on the welcome screen or click Library at the top of the workspace sidebar.

How do I see the raw markdown source of a document?

Press ⌃⌘S or click the </> toolbar button. Toggles between rendered preview and read-only monospaced source. Tap it again to go back. Useful for copying snippets exactly or checking what an LLM produced.

How do I open the outline / table of contents?

Press ⌥⌘O or click the outline icon in the toolbar. The outline scrolls with your reading position; click any heading to jump. As of 1.6.1 the outline appears instantly — no flash of empty panel on large documents.

I closed the main window on mac and can't get it back

As of 1.6.0 build 64: open the File menu — New Window (⌘N) is at the top. Or just click the Nota6 Dock icon — that reopens the window too.

How do I hide all the UI for distraction-free reading?

Press ⌘. to toggle immersive mode. Press ⌘. again to bring the toolbar and sidebars back.

Can I share rendered content into Slack / Notion / email?

Yes. Select text in the preview → right-click → Copy as Rendered. Nota6 puts HTML, RTF, and plain text on the clipboard simultaneously, so formatting (headings, code blocks, lists) survives the paste.

How do I save a Mermaid diagram or part of the page as an image?

Select any rendered content (or click a Mermaid diagram), then choose Save Selection as PNG… from the share menu or right-click. Output is 2× retina.

Mermaid diagrams are too small

Click any Mermaid diagram to open it in a zoomable modal. Scroll to zoom, drag to pan, esc to close.

How do I make Nota6 the default app for .md files?

The first time you launch Nota6 without opening a file, the welcome screen offers a one-click "Set as default" button. You can also right-click any .md in Finder → Get InfoOpen with → Nota6 → Change All….

My file isn't refreshing automatically

Make sure auto-refresh is enabled (toolbar menu). If your editor writes to a temp file and renames it (vim, Cursor, etc.), Nota6 handles that transparently via file-descriptor re-open.

The folder I picked has no files in the sidebar

Nota6 only displays Markdown files (.md / .markdown / .mdx) and hides empty directories. Common build/cache directories (node_modules, .git, build, etc.) are always skipped.

Can I run Nota6 from the terminal?

Yes. From the project repo, run bash scripts/install-cli.sh to install a nota6 command into /usr/local/bin. Then: nota6 some-file.md or nota6 docs/ (folder).

Do my settings sync between Mac, iPad, and iPhone?

Yes. Reading preferences (theme, font, font size, custom-theme colors, reading width) sync via your iCloud account. File contents, recent files, and scroll positions stay device-local. See the privacy policy for what does and doesn't sync.

Where are my recent files / preferences stored?

In standard system user defaults on your device. They never leave your device (except the preferences that go through iCloud). See privacy policy for the full list.

Keyboard shortcuts

Same set works on Mac and on iPad with a hardware keyboard.

ShortcutAction
⌘NNew Window (mac, 1.6.0+)
⌘OOpen file
⇧⌘OOpen folder
⌘PQuick switcher (workspace files)
⌥⌘OToggle outline panel
⌃⌘SView Source toggle (1.5+)
⌘.Toggle immersive mode
⌘FFind in document
⇧⌘FWorkspace full-text search
⌘RRefresh
⇧⌘RShow in Finder (mac)
⌘[ / ⌘]Back / forward (internal links)
⌘WClose file
⇧⌘EExport as PDF
⌥⌘EExport as HTML