Skip to content

Znote Release Notes

Anthony Lagrede Consulting · A macOS Markdown editor for local notes, with AI, runnable code blocks, MCP tool connections, and Git features built in.

CaskWriting & Notes 245
Install command
brew install --cask znote
30-day installs
5
#2331 in App
1-year installs
82
Last 365 days
Latest version
4.10.0
Download size
152MB
dmg
Release cadence
Weekly
1 release in 30 days
  1. 4.10.0

    Latest

    OpenNavo editorial Added to Homebrew

    Znote 4.10.0 redesigns the app and moves several controls.

    Znote 4.10.0 was released on 2026-11-07, and this update redesigns the app and moves several controls.

    • The app has a new look: dark theme, Settings and every dialog, the tree view, the note list, the outline, toolbars with new line icons, the AI bar, the recorder, and the command palettes. Lists show a single highlight, and the Material ripple is gone.
    • The toolbar adds a read-only mode and a Live edit / Source toggle. In read mode, copying gives plain text and the AI bar is hidden.
    • The footer is gone. Help, Settings, and Account move to the vault bar, and the AI model picker moves into the Ask AI bar.
    • NPM, Plugins, Functions, and MCP are now tabs inside Settings and no longer sit in the left bar.
    • Quick search (Cmd/Ctrl+T) works again as a keyboard-driven palette with recent notes and full-text results.
    • Paste any file: PDFs and documents copied from Finder or Explorer go into the vault attachments folder with a [[link]] that opens them in the default app. On macOS, several files can be pasted at once.
    • Show all file types is a new per-vault option that lists every file in the vault in the tree view.
    • Focus mode has a button that switches between the readable line length and full width for that focus session only.
    • PowerShell scripts export as .ps1.
    • The organization sign-in dialog is now in English and shows login errors inline.
  2. 4.9.3

    Patch

    OpenNavo editorial Added to Homebrew

    Fixes Windows shell code block execution and non-ASCII text display in PowerShell blocks.

    Windows
    Restores shell code block execution by preserving the original PATH.Fixes non-ASCII text display in Windows PowerShell 5.1 blocks.

    Znote 4.9.3 fixes two Windows issues. Shell blocks using powershell, pwsh, or cmd could fail before running code because Znote passed a broken PATH, preventing Windows from finding chcp in C:\Windows\System32. The original PATH is now preserved.

    Windows PowerShell 5.1 also misread non-ASCII characters in code blocks. Znote now saves the script in a format PowerShell reads correctly, fixing the display of characters such as 👋.

    Source: https://github.com/alagrede/znote-app/releases/tag/v4.9.3

  3. 4.9.2

    Patch

    OpenNavo editorial Added to Homebrew

    Fixes relative image paths, adds image browsing in the vault tree, and aligns linked-folder image listings across mount, refresh, and scan.

    Images
    Resolve relative paths from the note folder first.Browse vault images in the tree with thumbnails and a viewer.Align linked-folder image listings across mount, refresh, and scan.

    Znote 4.9.2 fixes relative image paths. Paths are now resolved from the note's folder first, then the vault root, and then the vault file index. This applies to live preview, note transclusions, copy-as-HTML, and PDF/HTML export.

    Vault images now appear beneath their folder in the tree with thumbnails. Selecting an image opens a viewer with its dimensions and file size, actual-size zoom, and options to insert it into the open note, copy its Markdown link, open it with the default app, or reveal it in the file manager. The attachments folder is shown as attachment storage.

    Linked external folders now produce the same image rows when mounted, refreshed, or scanned. Unmounting or deleting a folder removes its images along with its notes.

    Official release notes

  4. 4.9.1

    Expand

    OpenNavo editorial Added to Homebrew

    Fixes running code blocks with Cmd/Ctrl+Enter and displaying secret references in table cells.

    Fixed
    Cmd/Ctrl+Enter now runs a code block from anywhere inside it.Secret references in table cells now show the secret pill.

    Znote 4.9.1 fixes two behaviors. When the caret was near the top of a long code block, pressing Cmd/Ctrl+Enter could insert a newline instead of running the block because its runner had not yet been rendered. The shortcut now brings the runner into view and runs the block from anywhere inside it.

    References to secrets in table cells now display the same secret pill used elsewhere in a note. The pill updates when the vault is unlocked.

    Release notes

  5. 4.9.0

    Expand

    GitHub Release Added to Homebrew

    4.9.0 — Secrets, encrypted next to the note

    A dev note is full of things you cannot commit: a password, a token, an Authorization header. Either the note stays out of git, or the credentials get pushed. Now neither — the note stays plain Markdown and versioned, while its sensitive values live in an encrypted file beside it.

    • A reference, not a value — write secret:cisco.password in the note; the value lives in MyNote.secrets.yaml, encrypted. The Markdown never holds the secret, so the note stays safe to commit, to search, to send to the AI and to export.
    • Extract what is already there — select a password in your note, right-click → Secret → Move selection to the shared secrets… (or ⌘⇧S). Znote encrypts it and leaves the reference in its place; the cleartext never round-trips through the file.
    • Read it where you wrote it — a reference renders as •••••••• with a reveal and a copy without revealing button. No padlock to click: opening a note that uses secrets decrypts them.
    • One panel per note — More (…) → Secrets… shows both files side by side: reveal, copy, rename, delete, or move a value between the shared and the private one. A key the note references but the file does not hold gets a row with an input already waiting.
    • In code blocks — ${secret:api.token} is substituted when the block runs, through the environment, so the cleartext never reaches the temporary script file. Command output is masked before it is displayed and before it is saved back into the note.
    • Standard sops + age, not a Znote format — sops decrypt MyNote.secrets.yaml works from any terminal. A generated .znote/README-secrets.md tells whoever clones the repository how.

    Files that never leave your machine

    • Private notes — a note matching the private pattern (local-* by default) is kept out of git and carries a local badge in the tree, because nothing else on screen would tell you it is never committed.
    • Private values inside a shared note — a local: reference goes to MyNote.local.secrets.yaml, encrypted and never committed. Vault backups do include those files: they are the only copy that exists.
    • The rules are written for you — Znote maintains its own block in the vault's .gitignore. And since .gitignore only governs untracked files, it also runs git rm --cached on what the rules now cover, and tells you.

    A commit that still carries a password is stopped

    Before a commit made from Znote, the notes about to be pushed are scanned for plaintext credentials — known token shapes (GitLab, GitHub, AWS, OpenAI…), values on a credential line, high-entropy strings. The push stops, naming the file and the line. Always allow these silences a false positive for the whole team, and stores SHA-256 hashes only, never the string itself.

    This catches the slip made while working in Znote: no git hook is installed, so a commit from a terminal does not pass through it — the ignore rules above, on the other hand, apply whatever tool you use.

    Setup

    Install sops 3.10 or later and age, then point Settings → Secrets at your age key file. Znote never stores the key itself, only its path — and refuses a key file inside the vault, since the vault is the git repository. The ? button walks through the whole setup on macOS, Linux and Windows.

    📖 Documentation

  6. 4.8.0

    Expand

    GitHub Release Added to Homebrew

    4.8.0 — Git, from the tree

    If your vault is a git repository, the sidebar now drives it. No terminal.

    • Refresh also fetches — the ⟳ button on All files re-reads the disk and asks the remote what changed, without touching a single file.
    • Pull and push in one click — ↓ and ↑ appear only when there is something to do. ↑ stays greyed out until you have pulled, so a merge never happens behind your back.
    • See what moved — each note is marked: new (A), modified here (M), deleted (D), modified on the remote (I), or both (B). A folder shows the most urgent marker below it, even collapsed.
    • Conflicts never lose your work — the remote wins, but your local version is moved to the Trash first, restorable, and named in a toast.
    • External folders too — a mounted folder that is its own repository gets its own buttons, branch and remote. Commits stay scoped: two repositories can sit side by side in the same window.
    • Local state stays local — the trash, settings.json and metadata.json are ignored automatically, and untracked if your vault already committed them.

    Znote uses the git already installed on your machine, with your existing SSH key or credential helper. It never fetches, pulls, pushes or switches branches on its own.

    📖 Documentation

  7. 4.7.1

    Expand

    GitHub Release Added to Homebrew

    4.7.1

    Note list view

    The note list is now a view in its own right, closer to Apple Notes.

    • Folder column to the left of the list: pick a folder, the list shows its notes. Collapsible from the toolbar, and resizable — it takes room from the list, not from the window.
    • Tabs are hidden here, keyboard tab navigation included. They stay open in the background; going back to the tree view restores the tab bar with the active note alone.
    • The folder chip above the list only shows when the folder column is collapsed, and clicking it brings the column back.
    • Focus mode entered from this view no longer opens the "Open notes" panel, which lists the tabs this view hides.

    Left sidebar

    • Each view remembers its own width, and the sidebar can now be dragged 100px narrower, or up to 800px wide. Folder column state and widths are saved with the vault.
    • Folders with no sub-folder no longer reserve space for a chevron, leaving more room for long names.
    • Fixed: the note list and folder column came back at content height after a visit to the outline view (the outline panel was mis-sized too).
    • Fixed: the Trash and Bookmarked rows lost their counter in a narrow sidebar, even with room to spare.
    • Fixed: the bullet next to a note name was squashed by long names in a narrow sidebar.

    AI

    • Default provider on a fresh install is now OpenAI gpt-4.1 (empty API key), instead of a local llama3.2 that assumed Ollama was already installed.
    • Fixed: a 401 answered "Have you started your local LLM?" whatever the provider. Authentication errors now point at the API key; the local-LLM hint is kept for Ollama when no server answered.
    • Fixed: in the AI prompt overlay, the Down arrow erased a prompt you had not sent yet. The draft is now kept aside while you browse history, and restored on the way out.
  8. 4.7.0

    Expand

    GitHub Release Added to Homebrew

    Znote 4.7.0 — Znote for companies

    This release opens Znote to teams. Until now, AI in Znote was a personal setup: everyone brought their own key. Companies can now run it centrally, so every employee gets AI in their notes without a key to hand out — and without anyone losing sight of what it costs.

    For companies

    • Sign in to your company's organisation. From the account button in the bottom bar, sign in with your work email. Your company's AI becomes available in the app right away — nothing to install, no key to configure.
    • A dedicated AI provider. Once signed in, your organisation shows up in the AI provider selector as znote (Your company), alongside OpenAI, OpenRouter and Ollama. Pick it and every AI feature — chat, @-context, tool calls, transcription — runs through your company's setup.
    • Your provider is remembered. Znote comes back on your organisation after a restart, instead of falling back to another provider.
    • Managed from the web. Administrators run their organisation from organisation.znote.io: allowed email domains, seats, the models teams may use, and their own OpenAI key if they prefer to pay their provider directly. AI usage is reported per member, so the cost is known before the invoice.

    Improvements

    • Redesigned account popup: your organisation and email are readable at a glance, long addresses no longer stretch the window, and it follows the light and dark themes.
    • Clearer AI provider selector, with a shortcut to the AI settings when no provider is configured yet.

    Getting started

    Individuals: nothing changes — keep using your own key (OpenAI, OpenRouter, or 100% local with Ollama).

    Companies: create your organisation at organisation.znote.io, invite a first team, and see the real usage before deciding anything. Details on znote.io/company.html.

  9. 4.6.0

    Expand

    GitHub Release Added to Homebrew

    Znote 4.6.0 — UI improvements

    New

    • Rename a vault folder from the treeview, via the right-click menu. The folder is renamed on disk, and the notes it contains — including those in its subfolders — follow automatically.
    • New "Accent on selection" setting (Settings → Editor → Interface). Shows a colored bar on the selected item: note, folder, active tab, settings menu, and the AI overlay's border. Off by default.
    • Close button in the AI overlay. It could previously only be dismissed with the keyboard (Esc).

    Interface

    • AI overlay — the four-color gradient border is replaced by a quiet frame; the accent now lights up only while the overlay is engaged (typing a prompt, or an answer streaming). The input loses its redundant inner outline, and the floating button no longer overlaps the overlay.
    • Tables — the full grid around every cell gives way to a single rule under the header plus row banding.
    • Task checkboxes — drawn in the app's own colors instead of the macOS system blue. A - [ ] no longer shows both a bullet and a checkbox.
    • Tabs — the active tab is marked by an accent bar, and inactive titles are dimmed.
    • Treeview — the note marker is now a filled dot; the old hollow ring read as an unselected radio button.
    • Note list — tighter rows, with the name and date reading as a pair.
    • Outline panel — the [h1], [h2]… labels are gone, replaced by a hierarchy carried by indentation and type scale; each row is now a full-width click target.
    • Settings window — fixed height, so it no longer resizes as you move between tabs; redesigned side navigation, and the header is now separated from the content.
    • Slim, consistent scrollbars throughout: Outline, the "New Note" template browser, and the settings lists.

    Fixes

    • Linking an external folder under a subfolder failed with "Cannot read properties of undefined", or silently attached the folder to the wrong parent.
    • The accent color did not follow the selected theme: switches stayed orange under light themes.
    • In Settings, the Prompts, MCP and LLM lists are taller, and their action buttons ("New custom prompt", "Open mcp.json", "Add New llm") stay visible no matter how many entries there are.
    • The JSON config sample in the MCP tab was cut off on the right; it now scrolls.
    • The OpenAI provider detail no longer forces vertical scrolling.
    • The / and @ suggestion lists in the AI overlay used the OS scrollbar instead of the app's.
  10. 4.5.3

    Expand

    GitHub Release Added to Homebrew

    🎁 New: referral program

    Share Znote with friends and get your license for free.

    Grab your personal referral code in AI Settings and send it around: once your friends have joined and given Znote a real try, your license is on us — and they get 20% off theirs.

  11. 4.5.2

    Expand

    GitHub Release Added to Homebrew

    Fixed

    • AI: /rewrite and /edit no longer fail with reasoning models (GPT-5 family). Reasoning models spend their hidden "thinking" tokens inside the response token limit. On long notes, the chat-sized limit (default 1500) was entirely consumed by reasoning before the first visible character, so the final "Rewrite note" step came back empty and Znote reported "No rewrite produced" — while non-reasoning models like gpt-4.1 worked fine. Rewrite generations now use a dedicated 16k-token budget, sized for reasoning plus a complete note body. This also removes the risk of a long rewrite being silently truncated by the chat response-length setting. Models with a smaller context window are unaffected: if they can't accept the raised budget, the cap is automatically dropped and the request retried.
  12. 4.5.1

    Expand

    GitHub Release Added to Homebrew

    Znote 4.5.1 — MCP servers work out of the box, everywhere

    4.5.0 shipped MCP support tested from the dev environment — where the app inherits the terminal's PATH and everything resolves. The packaged app doesn't get that luxury, and Windows adds quirks of its own. This release makes MCP servers start reliably on a fresh machine, on all three platforms.

    Fixes

    macOS / Linux
    • MCP: the packaged app couldn't find npx / uvx (GUI apps get a minimal PATH that ignores your shell config — version managers and keg-only Homebrew installs like node@22 were invisible). Znote now captures your login shell's PATH once and resolves commands exactly like your terminal does
    • MCP: ~ in a server's command, args or cwd (e.g. --db-path ~/data/app.db) is now expanded properly
    Windows
    • MCP: npx servers failed on a fresh Node.js install with ENOENT lstat ...\AppData\Roaming\npm — npm never creates its global prefix folder until the first install -g. Znote now creates it
    • MCP: server arguments carrying cmd.exe special characters broke the launch — "mcp<2" was parsed as a file redirection ("The system cannot find the file specified"), and paths with spaces split apart. Arguments are now properly quoted
    • MCP: a missing runtime showed a raw localized cmd.exe message instead of the install hint. Znote now probes the command first and tells you exactly what to install (winget install astral-sh.uv, …)
    • MCP: a runtime installed via winget could stay invisible to the app even after a reboot. Znote now reads the user/system PATH from the registry — if a fresh terminal finds it, so does Znote
    All platforms
    • MCP: after installing a missing runtime, hitting Test again picks it up immediately — no app restart needed (on Windows the cached PATH is re-read from the registry)
  13. 4.5.0

    Expand

    GitHub Release Added to Homebrew

    Znote 4.5.0 — MCP: your notes, connected to everything

    Znote now speaks the Model Context Protocol. Plug any MCP server — GitHub, Postgres, Slack, Linear, your filesystem — into your vault, and your ```ai blocks can use its tools: query a database in plain English, turn meeting notes into issues, build your morning brief from your real data. No plugin to write, no glue code.

    ✨ MCP servers in your AI blocks

    • One config file, the standard format. Declare servers in .znote/mcp.json — the same format as Claude Desktop, so any server's README config pastes as-is. Local-first: servers run as processes on your machine, spawned and stopped by Znote.
    • tools= now takes MCP servers. ```ai tools=github exposes all the server's tools to the model; tools=github.list_issues exposes a single one. Mix them freely with your custom JS functions: tools=postgres,myFunction.
    • Settings → MCP. A new settings tab lists your servers, tests the connection and shows every tool a server provides. A shortcut lives in the footer (the MCP logo).
    • One-click install from any note. A ```json block containing an mcpServers config shows a "+ mcp.json" button that merges it into your vault config — recipes and READMEs become installable.
    • Helpful when things go wrong. Missing runtime? The error tells you the exact install command for your OS (brew install uv, winget install astral-sh.uv…). Provider refuses the request? You see the real error instead of a silent failure.

    ✨ AI answers saved into your notes

    • AI block answers are now persisted — as rendered markdown right below the block, delimited by invisible markers. Headings, bullets and code render normally in Znote and in Obsidian's reading mode.
    • Re-running replaces the previous answer instead of piling text below the block. Controlled by the same setting as runner results, with per-block save; / noSave; overrides.

    ✨ Obsidian companion 0.3.4

    • ```ai blocks get a purple accent in Obsidian (reading view and editing mode), using your theme's palette purple.
    • "▶ Run in Znote" on AI blocks too — click in Obsidian, run in Znote, and the rendered answer appears back in your Obsidian note.

    🧪 22 ready-to-run examples

    The examples/mcp folder has one note per server — Filesystem, Postgres, SQLite, GitHub, Playwright, Linear, Jira, Notion, Slack, Google Workspace, Stripe, Sentry, Grafana, Zapier and more — each with the exact config, prerequisites and prompts you can run as-is.

    Fixes

    • AI: newest OpenAI reasoning models (gpt-5.6 family) no longer fail on tool calls (reasoning_effort is disabled automatically on /v1/chat/completions tool requests)
    • AI: tool-call API errors now surface as a warning instead of a misleading "I don't have access" answer
  14. 4.4.1

    Expand

    GitHub Release Added to Homebrew

    Fixes

    • Linux: fix startup crash (GTK 2/3 and GTK 4 in the same process is not supported) on recent distros by pinning GTK 3
    • AI assistant: the prompt input now gets focus when opening the overlay (Ctrl+H) with a text selection
    • Settings: themed thin scrollbar on the AI prompts list
  15. 4.4.0

    Expand

    GitHub Release Added to Homebrew

    Znote 4.4.0 — Obsidian integration

    Run your code blocks in Znote, read the results in Obsidian. This release makes executable code blocks fully compatible with Obsidian vaults, in both directions.

    ✨ Code block results saved into your notes

    • Text results are persisted in the markdown itself. Running a js (//exec: node) or bash/powershell block writes its output right below the code fence as a plain ```output block — readable in Obsidian, on GitHub, anywhere. Re-running updates it in place, Clear removes it.
    • Rich results (charts, tables, HTML) saved on demand. A new camera button on the runner snapshots the rendered result as a PNG in your attachments folder, referenced with Obsidian's native embed syntax (![[znote-run-… .png|width]]) — pixel-aligned with the live result, sharp on retina displays, and re-running or clearing the block cleans it up.
    • Copy button on saved snapshots — hover a saved result image to copy it to the clipboard at full resolution.
    • Enabled by default ("Persist code block results", saved per vault; use noSave; on a fence to skip a single block).
    • Results survive restarts and are included in PDF/HTML exports.

    🔗 Obsidian companion plugin

    A new plugin, installable in one click from Znote (proposed the first time you open an Obsidian vault, or from the editor settings):

    • "Open in Znote" from the command palette, file/editor context menus, the ribbon, a note header action — and a hover "▶ Run in Znote" button on executable code blocks, in both reading view and editing mode.
    • Saved ```output blocks are styled as labeled RESULT panels in reading view.
    • Powered by a new znote://open deep link: known vaults open instantly (including from a cold start, straight into the right note); a vault Znote has never seen asks for confirmation first, showing the exact paths.

    🎨 Editor

    • Readable line length — the editor now uses Obsidian's 700px column by default. New toggle in the editor settings, and in Obsidian vaults the .obsidian/app.json value is followed (and written back), like Inline title.
    • Obsidian image size syntax ![[image.png|640]] is now rendered by the editor.

    🐛 Fixes

    • Images (pasted or saved results) were missing from PDF/HTML exports; runner results could also be attached to the wrong code block in exports.
    • Unsaved edits could silently skip autosave after a file was added to the vault (attachments, image paste) while typing.
    • Spurious scrollbars on ApexCharts and gridjs results with classic macOS scrollbars; wide datagrids no longer stretch the whole note.
    • Restored results after scrolling in long notes: no more doubled display, lost gridjs styling, or misaligned/offset snapshots.
  16. 4.3.2

    Expand

    GitHub Release Added to Homebrew

    ✏️ New /edit prompt — rewrite just the selection

    Select a passage, type /edit with your request — make it shorter, fix the tone, turn it into a list — and only that passage gets rewritten, in place. No request? It simply makes your text clearer and tighter.

    • Surgical: the rest of the note is never touched, one undo restores the original.
    • Safe: a reply that isn't a real rewrite never reaches your note.
    • Yours: like every prompt, override it (or build your own replaceSelection command) with a simple markdown file in prompts/.
  17. 4.3.1

    Expand

    GitHub Release Added to Homebrew

    🔧 v4.3.1 — /rewrite reliability fixes

    Some models replied "Hit Rewrite note!"… to the button you just pressed — and that chatty reply could even replace your note. Fixed:

    • The final generation now runs under a dedicated rewrite-engine prompt (no more interview persona fighting the instruction), with one automatic retry if the model still doesn't comply.
    • A strict output contract: anything that isn't a real rewrite never touches your note — the reply just lands in the chat and the session continues.

    Rewrites stay atomic (one undo restores everything) and your frontmatter is always preserved. Custom replace: true commands benefit automatically.

  18. 4.3.0

    Expand

    GitHub Release Added to Homebrew

    ✨ v4.3.0 — Slash Prompts: your AI just learned some serious new tricks

    Open the AI overlay and type /. That's it. That's the release.

    Well, almost — here's what's hiding behind that little slash. 👇

    💬 Interactive AI sessions

    Some things shouldn't be a one-shot prompt. The commands marked 💬 open a live chat inside the overlay — the AI asks, you answer, and nothing touches your note until you hit Generate draft. Then the whole conversation turns into a clean, structured note.

    • /brainstorm — shape an app, a screen or a half-baked idea, one sharp question at a time
    • /interview — build a real user-interview guide (it will call out your leading questions 😉)
    • /critique — a fair but merciless devil's advocate. Bring your best arguments.
    • /discuss — an open discussion with a partner that actually has opinions, wrapped up as a summary note

    Sessions see your current note and selection, resolve @note / @file mentions in every message, and can search the web mid-conversation. Escape hides the overlay — your session is still there when you come back.

    ♻️ /rewrite — the note blender

    The one we're most excited about. Your note grew messy — duplicated sections, answers scattered at the bottom, structure gone sideways? /rewrite proposes a rewrite plan, lets you adjust it in the chat, then rebuilds the whole note in place.

    Built paranoid, on purpose: the rewrite lands as one atomic edit (a single undo brings everything back), your frontmatter is preserved untouched, and if the model replies with anything that isn't a rewrite, the note stays exactly as it was.

    📁 A prompt library that is yours

    Every command is just a markdown file in your vault's prompts/ folder:

    • Override any built-in — the file wins, and a version chip tells you when the built-in default evolved since
    • Drop a new file, get a new command — frontmatter picks the behavior: interactive: true for a chat session, replace: true for a rewriter, category: to organize your own folders in the / list
    • Plain notes, versioned with your vault — your whole team shares the same commands

    New Settings → Prompts screen to see everything at a glance, generate any default file, scaffold a custom command, or reset to factory prompts.

    Also in this release

    • One-shot classics, tidied into folders: 📁 Spec kit (/specify, /plan, /tasks, /premortem, /review…) and 📁 Notes (/summarize, /eli5)
    • Copy button on chat replies
    • Visible focus state on text fields in dark mode, and assorted dark-mode dialog fixes

    Type /, poke around, and tell us which custom command you build first. 🚀

  19. 4.2.4

    Expand

    GitHub Release Added to Homebrew

    Fixed

    • Latest OpenAI models (GPT-5.x, o-series) failed with Unsupported parameter: 'presence_penalty' — unsupported sampling parameters are now detected and skipped automatically, for OpenAI and OpenAI-compatible providers.
  20. 4.2.3

    Expand

    GitHub Release Added to Homebrew

    What's New

    New

    • Hide code in code blocks — add hide; to a code fence (e.g. ```js hide;) to hide the code in the editor and in exports. Executable blocks keep their play/clear buttons and output; click the collapsed line to edit the source.

    Fixed

    • File tree could get out of sync with the disk — it now resyncs automatically on window focus, and "All files" has a refresh button to reload from disk anytime.
    • Copying a note no longer shows the original's code execution results in the copy.
    • PDF export now includes a code block's result after its first run (no re-run needed).
  21. 4.2.2

    Expand

    GitHub Release Added to Homebrew

    Znote 4.2.2

    Small bugfix.

    • 🩹 No more content loss on a fresh note: pasting into a just-created note and switching away immediately could lose the pasted content — every edit is now reliably saved, including a single paste right after creation.
    • 💾 Edits survive a quick quit: a change made in the very last second before closing the app is now flushed to disk.
    • 🔄 Sync-friendly closes: closing Znote no longer rewrites the active note when nothing changed — sync tools (iCloud, git, Obsidian Sync…) stop seeing a phantom modification on every close.
    • 🔗 "Reveal in Treeview" works on linked files: it now expands the "Linked files" group and highlights the file.
  22. 4.2.1

    Expand

    GitHub Release Added to Homebrew

    Znote 4.2.1 — Vaults & Obsidian compatibility 🔮

    Your notes are now plain Markdown files in a vault — no more internal database.

    • 🗄️ Vaults: a vault = a folder of .md files. Multiple vaults, one window each, with a vault switcher. Existing notes are migrated automatically (legacy data kept as backup).
    • 🔮 Obsidian compatible: open your Obsidian vault directly — [[wikilinks]], ![[Note]] transclusion, ![[image]] embeds, callouts, shared attachments folder. Znote never rewrites your content.
    • ✏️ Inline note title: a dedicated title field renames the file; the first line is just content now. Toggleable per vault, synced with Obsidian's setting.
    • ⚡ Fast on large vaults: typing stays smooth with hundreds of notes.
    • 🖱️ Native menus: right-click menus everywhere are now real OS menus — including the editor's, with AI actions built in.
    • 📤 Export options: pick title, orientation, scale and destination before exporting to PDF/HTML.
    • 🔎 ⌘F in-note search and ⌘K highlight.
    • 🎙️ Audio reworked: recordings embed inline with a native player and one-click transcription.
    • ✍️ Editor & AI: collapsible sections, @ note mentions in AI prompts, selection kept & highlighted while you prompt.
    • 🎨 UI refresh: all-files view, quick-search palette, tree, dialogs, slim scrollbars — plus a new app icon and a rebuilt 8-bit Retro theme.
    • 💥 Removed: tags, note history, the Attached-files panel — see full changelog below.

    Full details ⬇️

    Znote 4.2.1 — Vaults, plain Markdown storage & Obsidian compatibility

    This is the biggest release since Znote 4.0. Your notes are no longer stored in an internal database: a vault is now just a folder of Markdown files on your disk — readable, syncable, and fully compatible with Obsidian.

    🗄️ Vaults — your notes are plain .md files

    • A vault = a folder of Markdown files. The folder tree is your note tree. No more internal SQLite database — what you see on disk is what you get in the app.
    • Multiple vaults, multiple windows. Each vault opens in its own window. Switch or open vaults from the new vault switcher at the bottom of the sidebar (Obsidian-style), with a "Show in explorer" shortcut on every vault.
    • Open any Markdown folder as a vault — point Znote at an existing folder of .md files and start working.
    • Automatic migration. On first launch, your existing notes, folders, uploads and trash are migrated to ~/Documents/Znote. Your previous data is kept untouched as a backup.
    • Live filesystem sync. Edit a note in another app (or let your sync service update it): Znote picks up external changes automatically. Conflicts on a note you're editing are detected and surfaced instead of overwritten.
    • Vault-based backup: back up or restore a vault as a simple zip of the folder. The Backup settings now show your vault and app folders with one-click "Show in explorer".

    🔗 Linked files & folders

    Work with files that live outside your vault without moving them.

    • "Link external folder…" mounts any folder into the tree (previously "Open Real Folder"); hover a linked folder or file to see its real path in a tooltip.
    • A dedicated "Linked files" group in the tree gathers individually linked files — no more mixing with your vault notes at the root. The file icon now marks only files that live outside the vault.
    • "Show in explorer" on linked files and folders reveals them in Finder / Explorer.
    • Safe drag & drop: dropping a linked file into a vault folder now asks for confirmation before physically moving the file into the vault.

    🔮 Obsidian compatibility

    You can now open an Obsidian vault directly in Znote — and go back to Obsidian anytime. Znote never rewrites your content.

    • [[Wikilinks]] rendered and clickable, with [[ autocompletion, |aliases, frontmatter aliases and #heading navigation.
    • ![[Note]] transclusion — embed a note inside another.
    • ![[image.png]] embeds, resolved anywhere in the vault, Obsidian-style.
    • Callouts (> [!note], > [!warning], …), %%comments%% and ^block-anchors.
    • Attachments follow Obsidian's rules: pasted images go to your configured attachment folder (attachments/ by default), linked with relative ![[name]] — no more absolute paths. The media folder is kept out of the note tree.
    • Inline note title (Obsidian parity): notes have a dedicated title field at the top of the editor that renames the file. The first line of your content is just content — it will never rename your note again. A new "Inline title" setting (per vault) lets you hide it; a small editable tab title bar takes over, and the option follows .obsidian/app.json in Obsidian vaults.
    • Exports (PDF/HTML/…) resolve wikilinks and embeds properly.

    ⚡ Performance

    • Typing is fast no matter the vault size. On an 800-note vault, keystroke cost went from ~220 ms to ~5 ms, and the periodic UI freezes while typing are gone — the sidebar, tabs and lists no longer re-render on every save.

    🖱️ Native menus & dialogs

    • Every context menu is now a real OS menu: note & folder actions in the tree, Share, the editor layout switch, sort menus — and the editor's right-click menu, with Format / Paragraph / Insert / Tools and the ✨ AI actions as native submenus (native cut/copy/paste finally pastes images too).
    • "Move to folder…" palette: moving a note now opens a small searchable picker with keyboard navigation instead of a giant folder menu.
    • Export options dialog: exporting to PDF/HTML first asks whether to include the file name as title — plus landscape and downscale options for PDF — then lets you choose the destination file instead of dropping a print.pdf in a temp folder.

    🎙️ Audio, reworked

    • Recordings are saved as regular files in your attachments folder and embedded inline wit a native audio player right in the note (![[recording.webm]]).
    • One-click transcription from the player — the transcript is inserted just below the recording. Transcription is more robust on Windows, with clearer errors and a fallback when no OpenAI key is configured.
    • The separate "Attached files" panel and floating audio player are gone: everything lives in the note.

    ✍️ Editor & AI

    • ⌘F opens an in-note search panel (with replace).
    • ⌘K toggles ==highlight== on the selection.
    • Insert → Collapsible in the right-click menu inserts a foldable section.
    • @ note mentions in AI prompts: reference any note in the AI overlay or in ```ai blocks — its content is inlined into the prompt, and mentions render as clickable links.
    • Your selection survives the AI overlay: it stays visible (highlighted) while you type your prompt, and the answer is inserted on a fresh line below the selection — or at the very end of the note when nothing is selected.
    • AI prompt history is now per-vault.

    🎨 UI refresh

    • "All files" view redesigned: clean centered list with search, sort, dates and hover actions.
    • Quick search (⌘Y) restyled as a command palette, with highlighted matches, snippets and a Recent section.
    • Tree view polish: hover feedback, rounded selection pill, indent guides.
    • Restyled dialogs: note list, NPM packages & scripts, plugins, shortcut functions.
    • Slim rounded scrollbars everywhere — no more bulky native scrollbars on Windows.
    • New app icon: matches the new macOS rounded-corner mask (corners are no longer truncated) and is sharper on Windows.
    • Retro theme rebuilt for the new editor as a proper 8-bit, terminal-green arcade look (the Konami code still works 😉).

    ✨ Polish

    • Duplicating a note keeps its name: copy/paste in the tree (menu or ⌘C/⌘V) and "Duplicate" name the copy after the original file ("Note 1", "Note 2", …) instead of its first line — and never rewrite its content.
    • Templates & starter notes no longer duplicate their title: the leading heading is dropped since the inline title already shows it (the migration does the same for your existing notes).
    • Clearer menus: "New note" and "Open file" in the File menu and toolbar.

    💥 Breaking changes & removals

    • Tags are gone. With real folders, wikilinks and search, tags had become redundant.
    • Note history is gone — your files now live on disk, where your own backup/sync tools (Time Machine, git, iCloud…) do this job better.
    • The "Attached files" view and the floating audio player were removed (replaced by inline embeds, see above).
    • Notes are no longer renamed from their first line — use the inline title.
    • The old preview/split layout modes were removed: the editor is live-preview, with a Source mode toggle.
    • "Export folder" (tree) and the "Speakers" desktop-audio recording option were removed.

    🛠️ Under the hood

    • Massive internal refactor: the app was decomposed into focused hooks and services, ~200 dead imports/dependencies removed, and the whole storage layer rewritten around the vault.
    • Settings are now synced across vault windows on change (theme, AI settings, …) instead of last-window-wins.

    Upgrade note: the migration runs once, automatically. Your legacy data (database and uploads) is left in place as a backup and can be removed later from the Backup settings.

  23. 4.1.1

    Expand

    GitHub Release Added to Homebrew

    ✨ New

    🔍 Find in note (Cmd/Ctrl+F)

    The new editor now has a built-in search panel: press Cmd/Ctrl+F to search inside the open note, with match highlighting, match case / regexp / whole-word options, and find & replace. Press Escape to close the panel.

    🖍 Highlight shortcut (Cmd/Ctrl+K)

    Select text and press Cmd/Ctrl+K to wrap it in ==marker== and highlight it — alongside the existing Bold/Italic/Underline shortcuts.

    ⌨️ Keyboard help is back

    The keyboard shortcuts dialog returns to the footer, refreshed to match the current editor (removed obsolete entries, documents the new Cmd+K marker shortcut).

    🐛 Fixes

    • Crash when closing the app with a locked note active: closing while a locked (not yet unlocked) note was open crashed the save-on-exit flow and prevented the app from quitting. Locked notes are now left untouched on exit, and Save / Save As / Export / Duplicate are also guarded so they can no longer write stale content over an encrypted note.
    • Text shifting during search: highlighting a match inside a link, @note mention, ==marker== or inline code no longer makes the rest of the line shift by a few pixels.
  24. 4.1.0

    Expand

    GitHub Release Added to Homebrew

    ✨ Features

    • Added support for note includes using the @ alias.

      • You can now include the content of another note directly by referencing it with the @ alias.
      • This makes it easier to organize reusable content, create modular documentation, and avoid duplication across notes.

    ♻️ Refactoring

    • Performed a major code cleanup and refactoring across the project.

      • Improved the overall codebase structure and maintainability.
      • This release includes many internal changes aimed at making future development easier and more reliable.

    Note: Because of the scale of these internal changes, there may still be a few undiscovered issues. If you encounter any bugs or unexpected behavior, please don't hesitate to open an issue or get in touch. Your feedback is greatly appreciated!