Skip to content
Varlig Guide
Varlig home

Settings

Varlig works well straight away, and Settings is where you make it yours: how notes start, when private notes lock, how answers look, and what Varlig may do online. This page walks through every pane in the order Varlig shows them, with each option’s default.

Open Settings with Varlig › Settings… (⌘,), or click the gear at the top of the sidebar.

Settings is laid out like System Settings. Its sidebar starts with Search settings, which finds the pane for a word such as backup or currency, then a card showing what iCloud sync is doing, then the panes in groups, each with a coloured icon. Every pane opens with a short description of what it’s for. On iPhone and iPad, see Themes and Settings on iPhone and iPad.

General

The everyday behaviour of the app and the editor.

Language, in this pane, chooses the interface language. System follows your Mac’s language preferences. A new choice applies after restarting Varlig; Restart Now saves your work and reopens the app. Calculation input and answer formats are separate, under Calculations.

On launch

Setting What it does Default
Resume where I left off Reopens the last note with its scroll position, cursor and selection. Turning it off forgets them. On
Remember window position and size Reopens the main window where you left it, or on another screen if that one is disconnected. On

Workspace

Setting What it does Default
Show word count Shows the note’s word count, and its writing target, at the bottom of the editor. Off
Show back and forward buttons Adds Back and Forward buttons to the note header (⌘[ and ⌘]). Off
Show formatting toolbar Shows formatting buttons above the note (⇧⌘Y). Off

Formatting toolbar

While the toolbar is shown, this group pins more buttons after the standard ones: Undo and Redo, Calculation Block, Code Block, Math and Current Date. None is pinned to begin with. A pinned button never pushes out a standard one — in a narrow window the pinned ones go first — and each stays in the toolbar’s More menu and the menu bar either way.

Setting What it does Default
Show Varlig in the menu bar Puts Varlig beside the clock, where it opens the scratchpad. Off
Show Dock icon Appears once the menu-bar item is on. Turning it off keeps Varlig running in the menu bar alone. On

Keyboard shortcuts

Three shortcuts work from any app: Open Varlig, Create a new note and Show scratchpad. Show scratchpad starts as ⌃Space; the other two work once you record them.

Click Record Shortcut and press the keys you want. A shortcut must include ⌘ or ⌃. Press Escape to cancel, or click the clear button to remove a shortcut.

Editor

How writing behaves, and what a new note starts with.

Writing

Setting What it does Default
Check spelling while typing Underlines possible mistakes without replacing your words. Off
Autocomplete tags, wiki links and emoji Shows suggestions as you type a #tag, a [[ note link, a : emoji, a code block’s language or a calculation. On
Move completed tasks to the bottom Moves a todo below the unfinished ones when you tick it. Off
Close code blocks automatically Typing three backticks adds the closing fence. On
Insert matching brackets and quotes Adds the closing ), ], }, " or ` after the caret. Typing it again steps over it, and Delete removes an empty pair. Off

A note can override spelling on its own: the … menu’s Spelling submenu turns checking on or off for that note and pins its language.

Setting What it does Default
Auto-fill titles when pasting web links Contacts the linked website to fetch its title. Links still work without it. Off

Pasting a web address over selected text always makes a link, whatever this is set to.

New notes

Setting What it does Default
Start with What a new note begins with: a heading from Heading 1 to Heading 6, today’s date or date and time (long or ISO 8601 format), or nothing. Heading 1
Add tags at Where the tag goes when you create a note while a tag is selected in the sidebar: Top of note or Bottom of note. Bottom

Record time spent editing each note is off by default. Turned on, the word-count capsule also shows something like 12 min editing. It counts the time between edits you make in the editor and stops after a minute without one, while Varlig is in the background, and while the app is locked — so thinking, reading and leaving a note open overnight count for nothing. It is kept on this Mac only, never in the note, in sync or in a backup, and Remove All deletes it. It records the edits Varlig saw; it is not a record of who wrote anything.

Scroll long code lines instead of wrapping is described in Long lines.

Remember answer formats in Markdown files is on to begin with. It keeps each line’s answer format with a Markdown file you open in place, in the file’s metadata; see Answer formats stay with the file.

Text Transformations

Saved find-and-replace rules you apply yourself from Format › Transformations, after a preview. The list is empty to begin with, and nothing runs a transformation on its own. See Saved text transformations.

Journal & Review

Daily and weekly notes chooses what today’s note and this week’s note start from: a date or week heading, or one of your templates.

Review sets how many notes the review queue offers each day, from 1 to 50, and the tags never to review. Review choices and the daily and weekly templates are stored on this Mac; when each note was reviewed is stored in the library.

Typography

Fonts, text size and the shape of the page: the interface, text, heading and code fonts, plus font size, line spacing, line width, paragraph spacing and paragraph indent, with a preview that changes as you do. Themes, fonts and icons covers each one.

Themes

The colours of your workspace, as a gallery you can search, with your own themes beside Varlig’s. System follows macOS light and dark mode. See Themes, fonts and icons.

App Icon

Choose Varlig’s icon in the Dock and Finder. See Themes, fonts and icons.

Calculations

How calc blocks read numbers, show answers and fetch exchange rates.

Numbers

Setting What it does Default
Number format How numbers in calculations are read, and how answers are written unless Answers says otherwise. Choose System Region, which follows your Mac, or one of 15 languages and regions, each shown with a sample, such as English (United States) · 1,234.56, German (Germany) · 1.234,56 or French (France) · 1 234,56. It also sets which way round slashed dates go: 05/06/2026 is May 6 in English (United States), and 5 June in most of the others. With System Region and a day-first English region, such as the UK, Ireland, Australia, New Zealand, India, South Africa or Switzerland, answers show the day first too: 14 June 2025 rather than June 14, 2025. An example shows the result. English (United States)
Convert foreign numbers when pasting When you paste into a calc block, converts numbers written in another format, as long as they can only mean one thing. Something like 1,234 is left alone. Off

Answer formatting

Setting What it does Default
Answers How answers write numbers, money and dates. Same as Number Format writes them the way calculations are read; choose another to read one way and answer another. With Number format on German (Germany) and Answers on English (United States), 1,5 + 1 answers 2.5. Same as Number Format
Round to … dp The most decimal places an answer shows, from 0 to 15. 10
Show thousands separators Writes 12,500 rather than 12500. On
Use notation for large numbers Shortens numbers of 100,000 or more with k, M, G, T and P, and money of a million or more with M and B. On

These are the defaults for every line. To change one line, use the menu on its answer.

Answers changes only how answers look. What a line means, the order of a slashed date and which currency $ or kr names still follow the number format, and an answer copied back into the note is written the other way; Convert foreign numbers when pasting converts a single pasted number. A note can have its own Number format and Answers in Calculation Settings for This Note…, from the Calculation Line menu when you right-click a calculation or under Calculations in the note’s … menu.

Currency

Setting What it does Default
Round to currency precision Rounds money answers to the currency’s usual decimal places. Named values keep full precision. On
Use currency symbols Shows $15.00 instead of 15.00 USD. On
Keep trailing zeros Shows $15.00 instead of $15. On

Calculation summary

While you work in a calc block, or select some lines, a floating summary adds them up. It only adds lines in the block’s main unit or currency and leaves counts and other units out, as The summary under each block explains.

Setting What it does Default
Show floating summary Turns the summary on or off. On
Statistic What the summary shows: Total, Average, Count or Median. Total
Include variable declarations Counts lines like rent = £950 in the summary. On
Include referenced lines Counts lines that other lines refer to. On

Each block’s summary menu can change these for that block.

Variables

Setting What it does Default
Update references when renaming When you rename a value and move to another line, updates the lines below that use the old name. Off
Reset local variables and tags at dividers A line of three or more hyphens (---) inside a calc block starts fresh: names, units and functions defined above it stop applying, and the running total restarts. A total line also starts a new section at a --- divider or a # heading. When off, the line is a comment. On

Everyday calculations

Setting What it does Default
Hours per workday How long a workday is, from more than 0 up to 24 hours. 8
Sales tax name The name of your sales tax, such as VAT or GST. Once it has a name, you can write lines like £120 plus VAT, £120 after VAT, £144 without VAT or VAT off £120. Empty
Sales tax rate The rate for that tax, from 0 to 100%. 0%
Public holiday calendar The country whose public holidays you keep. Workday counts and workday shifts then skip those days as well as weekends, including lead times such as second business day after 3 December 2026, and short lines like holidays in 2027, next public holiday and is 25 December 2026 a holiday have a calendar to answer from. Choose from the 23 built-in calendars. None
Income tax country The country whose tax schedule answers income tax on £55k and the other income tax phrases when a line doesn’t name one. None

Type these numbers with a full stop as the decimal point, whatever your number format.

Both of the last two settings are shortcuts rather than switches: a line that names a country of its own always wins, so public holidays in Ireland in 2027 and income tax on €55,000 in Germany give the same answer whatever you’ve chosen, and they work before you choose anything. Leave a setting on None and the short forms ask you to name a country instead of guessing one from your Mac’s region.

Income tax answers are estimates for a single person claiming the standard allowance, so treat them as a guide rather than a tax return. Income tax lists every country, its tax year and what the figure leaves out, and Public holidays covers the holiday phrases.

Shared definitions

Values, units and functions you write here work in every note, so you don’t have to define them again. For example:

calc
discount = 10%
1 widget = 5 meters

Workday holidays

Extra days off that workday counts should skip, one date per line in YYYY-MM-DD form. Out of the box only Saturdays and Sundays are skipped. Add days and lines like December 24 2026 + 2 workdays or workdays until 4 January 2027 skip them too:

2026-12-25
2026-12-28
2027-01-01

With those three dates listed, December 24 2026 + 2 workdays lands on December 30 instead of December 28.

This list and the Public holiday calendar above work together rather than replacing each other. The calendar brings in a whole country’s public holidays without any typing, and this list adds days it doesn’t know about: your company shutdown, a regional day such as a German Land’s Fronleichnam or an Australian state holiday, an inset day, or a Friday you’ve booked off. Use the list on its own if your country has no built-in calendar or you’d rather pick the days yourself. See Workdays and Public holidays.

Exchange rates

Refresh currency and crypto rates hourly is on to begin with. Varlig then:

  • downloads daily exchange rates from the European Central Bank and cryptocurrency rates from Coinbase when a calculation first needs them, and again once they’re an hour old
  • downloads exchange-rate history and US inflation figures soon after Varlig opens, for historical conversions and inflation calculations.

Turn it off and Varlig downloads nothing on its own. Refresh Now fetches everything once, whenever you choose. The pane shows when each source was last updated, and any problem in red. Varlig keeps the last rates it downloaded, so conversions keep working offline.

Live data

Two lookups that leave your Mac, each on to begin with: a line that names a place has asked for that lookup. They run only for an expression that needs them, never send the rest of the note, and take effect immediately.

Setting What it sends Default
Look up places and time zones The place named in an expression, to Apple’s geocoder. On
Look up weather conditions The place’s coordinates, to Apple WeatherKit. Needs place lookup. On

Turn one off and the lines that need it show no answer; everything else is unaffected. If you turned live data on or off in an earlier version of Varlig, that choice is kept. A status line under the switches says how the lookups are doing, including when Apple WeatherKit didn’t answer and that Varlig will ask again in a few minutes. Under the weather switch are the Apple Weather mark and its Other data sources link; see Weather.

Privacy

Locking, protected tags and where your notes may appear. What’s protected, at the bottom of the pane, explains exactly what encryption covers. See Privacy and locking.

Group Setting What it does Default
Protected notes Lock after Mac is idle Locks opened protected notes after this long with no input: Never, 1, 5, 15 or 30 minutes, or 1 hour. 5 minutes
Protected notes Lock protected notes when Varlig is inactive Locks them as soon as you switch to another app. On
Protected tags Tags Tags whose notes must be password-protected, such as private, finance/taxes. Empty
App access Lock all of Varlig after inactivity Hides the whole library after the idle time, rather than only locking protected notes. Off
App access Require Mac authentication at launch Opens Varlig to a lock screen. This does not encrypt the library. Off
Outside Varlig Show notes and calculations in widgets Shares unencrypted pinned notes and their tasks, and the answers of unprotected notes’ calculations, with Varlig’s widgets. Off
Outside Varlig Offer recent notes when sharing to Varlig Lets the Share menu append to a recently edited note. Off
Outside Varlig Include unencrypted notes in Spotlight Makes note content searchable from macOS. Off

Varlig has two widgets on the Mac, and both stay empty until Show notes and calculations in widgets is on: Varlig Notes & Tasks, with your pinned notes and their unfinished tasks, and Calculation, with one answer from a note you choose, as on iPhone and iPad. Neither ever shows a password-protected note, and while Varlig is locked both are empty.

Sync & Backup

Group What’s in it
iCloud Sync notes with iCloud (off until you turn it on), what sync is doing, and Sync Now or Try Again. Open at Login (off) opens Varlig when you log in, so your notes keep syncing. See iCloud sync and shared notes.
Automatic backups On by default: how often, how many to keep, which folder, and Back Up Now. See Version history and automatic backups.
Library backups Back Up Library… and Restore Backup… for a copy you keep elsewhere.
Local storage Where your library is, and a reminder that note history keeps up to 30 versions per note.
Storage What the database, attachments and pending recordings use, the largest attachments, Clear Preview Cache, and Unused attachment files › Review… for attachment files nothing uses.

Import & Export

Files holds Import Notes…, and Export holds Keep tags when exporting, which is the same setting as the export sheet’s Include tags.

Button What it does
Import from Bear Finds Bear on this Mac and copies in your notes and attachments. Bear’s library isn’t changed.
Import from Soulver Finds your Soulver sheetbook. Each sheet becomes a calculation note with its original file attached, and Soulver’s library isn’t changed.

Export Bear notes you’ve encrypted in Bear unlocked first, and let Bear download all attachments before importing. For other apps and files, see Import, export and backups.

Published snapshots lists every folder of read-only pages this library has written, says whether the notes have changed since, and holds Show in Finder, Update Snapshot… and Remove…. See Publishing a snapshot.

Advanced

Automation

Allow authenticated automation lets other tools and scripts work with your notes through varlig:// links. Turning it on creates a private token: Copy API Token copies it, and Reset Token replaces it. The token can read your unprotected notes and change the ones that aren’t read-only, so keep it private.

Desktop connector

Allow local MCP connections lets an AI assistant on your Mac search and read your notes through Varlig’s connector. It’s off to begin with.

  • Allow changes to notes also lets the assistant edit notes.
  • Only tags and Exclude tags limit which notes it can see. Separate tags with commas; nested tags are included, and exclusions always win.
  • Password-protected notes are never available.

An assistant may send the notes it reads to its own service, so choose tags carefully.

Crash and hang reports

The crash, hang and resource reports macOS gives Varlig: the last 20, and 10 days of performance figures, kept on this Mac and never sent by themselves. The line at the top says how many are kept and when the latest happened. Send Report… opens a sheet that lists each report and shows the file as it will be sent, then Email… addresses it to [email protected] and Share… sends it another way. Delete Reports… removes them. See Crash and hang reports.

Plan

The last pane: “See what Varlig costs, what it includes, and restore a purchase.” Varlig › Varlig Plan… opens it, and so does Varlig › Restore Purchases…, which starts restoring straight away. Varlig is free to download, and a plan is what lets you write. One plan covers your Mac, iPhone and iPad when they use the same Apple Account in the App Store; on iPhone and iPad this page is Settings › Plan.

This Mac says what this Mac can do now: Choose a plan to start writing before you’ve bought one, Your plan is active with the plan and when it renews, or Writing is paused with the date a plan ended. Until Varlig has been able to ask the App Store, it reads Varlig is unlocked: nothing is limited while it doesn’t know, and a check that fails later never takes anything away.

Plans lists Monthly, Yearly and Pay once, each with its price, its length (“1 month, renews automatically”, “1 year, renews automatically”, “Lifetime, never renews”) and how it’s billed. The prices come from the App Store, in your own currency and with any local taxes; until it answers, the list says “Asking the App Store for prices in your currency…”. Subscribe buys a monthly or yearly plan and Buy Once the one-time licence, and the plan you have says Current Plan. Under the list are “There is no free trial. To try Varlig, start with the monthly plan and cancel whenever you like.”, how subscriptions renew and are charged, and links to the Terms of Use and the Privacy Policy.

Restore a purchase is always there, so an existing owner is never sent through a purchase first. Beside Already bought Varlig? it explains: “Brings back a plan bought with this Apple Account, on this Mac, an iPhone or an iPad. Varlig never asks you to start a trial first.” Restore Purchases runs it, and becomes Try Again if an attempt is worth repeating.

What every plan includes says there are no feature tiers and no add-ons, lists the devices a plan covers, and explains cancelling: a cancelled plan keeps working until the end of the period you’ve paid for. Manage Subscription…, beside Change or cancel a subscription, opens your subscriptions in the App Store.

If a plan ends states what keeps working even then: “Your notes stay on this Mac and stay yours. Reading, selecting, copying, printing, export in every format with its attachments, version history and backups keep working offline and forever. Only writing new notes and editing existing ones needs an active plan.” Import and restoring a backup write into the library, so they follow editing. What your other devices write still syncs in.

Without a plan, a banner at the bottom of the library window says so, with Plan… to open this pane and Don’t Show Again. It’s never a sheet and never covers a note. Buying or restoring lets you write again at once, without restarting Varlig.

The pane closes with the part that doesn’t change: “Varlig has no account and no server: nothing about your notes leaves this Mac when a plan is checked.”

Options outside Settings

A few preferences live in menus instead:

Option Where What it does
Typewriter Scrolling View menu Keeps the line you’re typing vertically centred.
Show Scratchpad View menu Opens the scratchpad without the menu-bar item.
Toggle Style Bar View menu (⇧⌘Y) Shows formatting buttons above the note.
Zoom In / Zoom Out / Actual Size View menu (⌘+, ⌘−, ⌘0) Changes the text size, the same as Font Size in Typography.
Layouts View menu (⌃1, ⌃2, ⌃3) Shows the editor only, the notes and editor, or all three panes.
Tags › Sort By View menu Sorts tags in the sidebar by title or by note count.
Preview Style The menu at the top of the note list Small, medium or large previews, with or without attachments, and Group by Date for date headings.
View As The menu at the top of the note list List or Gallery. See Date headings and the gallery.
Customize Sidebar… View menu Which places are tiles at the top of the sidebar. See The sidebar.