Settings
Opening Settings
Section titled “Opening 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.
General
Section titled “General”| 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 |
Appearance
Section titled “Appearance”| 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.
Color themes
Section titled “Color themes”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.
Your own theme
Section titled “Your own 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.
Publishing
Section titled “Publishing”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.
License
Section titled “License”Shows who the copy is licensed to, with Change key, Show my devices and Deactivate. See the FAQ for licences and the trial.