Limits and known issues
Known edge cases and hard limits, so nothing here surprises you.
Saving
- Quitting with ⌘Q within about a second of your last keystroke can lose that last edit; the autosave hasn't caught up yet. Give it a moment, or press ⌘S, right before quitting.
Files and folders
- Dropping a
.txtfile from Finder onto a tracked folder can leave a row that disappears on the folder's next rescan, even though the file itself is still on disk. - Very large gitignored trees have no size cap; showing one can be slow.
- Scanning a folder stops after 50,000 subfolders. The sidebar marks itself incomplete and keeps counting; changes in the unscanned remainder go unnoticed until a full scan finishes.
- Content search only indexes files up to about 2 MB. Larger files are still listed and open normally, just not searchable by content.
- An HTML file shows without anything it loads from a relative path — a stylesheet, script, image or data file next to it. It has no access to the app or to files on disk. It can load scripts, images and fonts from the internet, but cannot embed another web page or replace itself with one. Links out of it do not open, and its text is not searched. A script in it that never finishes freezes the app window until you quit; the app does not reopen an HTML file at start. See HTML files.
Images
- Replacing an image file in place, keeping the same name, keeps showing the old picture in an open note until you reopen it.
- A standalone file, one opened without its folder, gets no live image updates at all.
- Images inserted through the toolbar are not compressed. Pasted or dropped screenshots are.
Tables
- A Mermaid diagram, an HTML block or comment, display math or a footnote entry dropped into a table cell is moved to just below the table when you save, and the cell is left empty. Nothing is lost — the block keeps its own text — but it no longer sits where you put it.
History
- The local file history's Git panel doesn't refresh after a commit made outside the app until you reopen or resave the file.
Export
- Math exports as its raw source text; it isn't typeset in the PDF or Word file. See Export.