Skip to content

Settings

macOS Windows / Linux
mdai → Settings… File → Settings…

It is also the gear button at the bottom of the left toolbar, Settings in the command palette (⇧⌘P / Ctrl+Shift+P), and the shortcut ⌘, / Ctrl+,.

The left side lists six groups: General, Appearance, Vault, Publishing, AI (with the AI providers under it) and License. Click one and its settings appear on the right. Settings opens on AI.

Setting What it does
Language English, Crnogorski, Deutsch or Español
Spell check On or Off
Default app for Markdown Makes mdai open .md files — see FAQ
Quick Capture shortcut The shortcut for Quick Capture, Control+Shift+Space unless you change it. Change… takes the next keys you press, Reset goes back. On Linux your desktop may manage it in its own settings
Pandoc Where mdai found Pandoc for the extra export formats, and Choose Pandoc… — see Export
Setting What it does
Theme Light, Dark or System — System follows your computer’s light or dark setting
Color theme Default, Paper, Sepia, Slate or Forest, plus any theme of your own — see Color themes. A new install starts with Default
Text font, Heading font, Code font Under Typography: the font for your text, for headings and for code — Newsreader, Source Serif 4, Literata, IBM Plex Sans, Inter or System for text and headings; IBM Plex Mono, JetBrains Mono or System monospace for code. From theme keeps the theme’s own font and Same as text gives headings the text font. The fonts come with mdai and work offline
Text size − and + change the size of the text, shown in pixels
Line spacing, Paragraph spacing, First-line indent Sliders for the space between lines, the space after each paragraph and the indent of a paragraph’s first line
Text width A slider: Narrow, Wide or Full — how wide the text column is. Wide is the default
Restore defaults Puts all of Typography — fonts, text size, spacing, indent and width — back as it came
Preview A short sample page that shows the current theme and typography as you change them
Custom CSS Your own styles for mdai

If your custom CSS hides something you need, View → Disable Custom CSS turns it off. While no custom CSS is set, that entry is greyed out.

mdai comes with five color themes: Default, Paper, Sepia, Slate and Forest. Each one has a light and a dark version, and Theme (Light, Dark or System) decides which of the two you see. Click a theme’s card in Settings → Appearance and it applies at once. Your custom CSS still applies on top of any theme.

A theme of your own is a .css file in the themes folder. Open themes folder in Settings opens it; after you add or change a file, click Reload themes. The first time you open the folder it contains an example, Example theme.css, to start from. Next to Open themes folder, How to make a theme opens a short guide. The file’s name, without .css, is the theme’s name, and it appears in the list marked Custom.

The file sets colors and fonts for the light version, the dark version, or both:

.theme-light {
--surface-content: #fdf6e3;
--text-primary: #3b3226;
--accent: #2e6b45;
}
.theme-dark {
--surface-content: #1f1f1f;
--text-primary: #e6e6e6;
--accent: #7fc794;
}

Anything you leave out keeps its Default value. These are the names a theme can set:

  • Surfaces: --surface-sunken, --surface-chrome, --surface-panel, --surface-content, --surface-hover, --surface-active
  • Text: --text-primary, --text-secondary, --text-muted, --text-inverse
  • Accents: --accent, --accent-hover, --accent-subtle, --accent-ai, --accent-ai-hover, --accent-ai-subtle, --accent-btn, --accent-btn-hover
  • Borders: --border-subtle, --border-default, --border-strong
  • States: --success-bg, --success-fg, --danger-bg, --danger-fg, --highlight, --scrim, --shadow-color, --scrim-tint
  • Text in your notes: --font-content, --font-mono, --leading-editor (line spacing)

mdai reads only these names from a theme file and ignores everything else — other selectors, @import, url(…) and !important. For anything beyond colors and fonts, use Custom CSS. If a file has none of these names, mdai says so and shows Default.

Setting What it does
Daily notes folder Where Open Today’s Note puts its notes
Daily note template The note a daily note starts from — see Daily notes. Choose… picks it from the vault
New note template The note every new tab starts from (⌘T / Ctrl+T and the + buttons), the same way
Create examples Puts daily, meeting and idea in templates/ in your vault, in the language of the app. Nothing already there is overwritten
New template… Makes an empty template in templates/ and opens it — the placeholders in it are filled when a note starts from that template
Pasted images folder Where pasted and dropped images go: next to the note (note-name.assets), attachments at the vault root, or attachments in the note’s folder. Applies to images from now on; existing ones stay where they are
Shrink large pasted images Off, or a size above which a pasted image is made smaller (the longest side goes to 2560 px). Off unless you turn it on. GIF, animated and transparent images are kept as they are
Name of new images image-1, image-2 … (the default), the note’s name, or the date and time. A number is added only when the name is taken; existing images keep their names
When moving a note: move its images On (the default): the note’s note-name.assets folder moves with it. Off: the images stay where they are and the links in the note are updated — see Vault
Clicking a folder opens its folder note Off (the default) or On — see Folder notes

Templates are explained end to end on Templates — where they live, what Create examples and New template… do, and every placeholder.

Your WordPress and Ghost sites for File → Publish…: add, edit or delete an account. See Publishing.

Anthropic, Gemini, DeepSeek, OpenAI and Ollama. For the first four you paste your own API key; the buttons under it are Save, Test Connection and Delete Key. Ollama needs no key, only Test Connection. Details are in AI setup.

Settings → AI shows whether sending to the selected provider is allowed, and since when. Withdraw permission removes it for that provider; the next AI request asks again. See AI setup.

Below the providers is External agents (MCP), off by default — see External agents.

Shows who the copy is licensed to, with Change key, Show my devices and Deactivate. See the FAQ for licences and the trial.