Settings Reference
Press Ctrl/⌘ + , to open Settings. Use the search bar at the top to filter any setting or shortcut by keyword, and click the ⌵ button next to the search box to step through matches with a visible pulse highlight.
1. General & File Safety
- Use first line of document as tab title (off by default): displays the first non-empty line of the document (skipping YAML front-matter) in the tab bar instead of the filename — ideal for notes opened with temporary or UUID filenames.
- Check if original file exists before saving (off by default): designed for editing temporary files opened by third-party software. When enabled, if the original file on disk has been deleted or cleaned up externally, background auto-save is skipped and manual save (Ctrl/⌘ + S) asks for confirmation before recreating the file.
- Automatically number 1–6 headings (off by default): keeps hierarchical section numbers (
1 / 1.1 / 1.1.1) updated automatically whenever headings are added, deleted, or modified. - Read-only file Save As guard: attempting to save a read-only file warns you and opens “Save As” pre-filled with
<name>-copy.md, and closing a modified read-only tab always prompts first. - Restore session & per-workspace tabs: reopens your tabs and exact viewport scroll positions on launch; each workspace folder remembers its own tab set independently.
- Auto-reload external changes: clean tabs reload automatically when updated on disk by external tools (Syncthing, Git); dirty tabs always ask before overwriting your edits.
2. Writing & Editor
- Word wrap, line numbers, active-line highlight, and readable column width limit.
- Always show Markdown syntax markers: keeps
**,#, and other markers visible at all times so lines never shift when moving the caret. - Pasted image destination & default width: choose shared
_assets/, per-note.assets/, or Typora-compatible./images/${filename}/templates; set a default width preset for pasted images and resize any image from the right-click menu. - Code block wrap, line numbers & language suggestions: soft-wrap long lines in code fences and toggle language autocomplete when typing
```. - Vim mode, Focus mode (F8), Typewriter mode (F9), and non-blinking solid cursor.
3. Appearance & Custom Themes
- Theme: Light, Dark, or Follow OS appearance, plus built-in community themes like Ivory Amber.
- Custom CSS & DevTools: write rules in
custom.cssand click “Open DevTools” (or press F12) to inspect live DOM elements. Active custom themes and CSS are also inlined automatically into HTML and PDF exports. - Fonts & independent font sizes: configure separate prose and code fonts, independent editor / UI / preview font sizes, and whole-app zoom (Ctrl/⌘ + +/−/0) with a centered percentage HUD. On Android, you can also load local font files from
/storage/emulated/0/Fonts.
4. Shortcuts & Writer Preset
- Click the “Writer (Typora / Word)” preset at the top of Settings → Shortcuts to bind Ctrl/⌘ + B to Bold (moving Toggle File Tree to Ctrl/⌘ + Shift + B).
- All 60+ commands are individually rebindable, and native menus reflect your active bindings immediately.
5. Sync, History, AI & Grammar Check
- Sync: WebDAV E2EE Sync, Local Cloud Drive Encrypted Vault Folder, Direct Cloud Drive OpenAPI Sync, and GitHub Sync (see the Sync & History guide).
- Language & Check: built-in spellcheck, CJK proofreading, and optional LanguageTool grammar & style checking (public API or self-hosted server).
- AI: 14+ BYOK cloud providers and local Ollama (see AI features). All API keys and cloud tokens are stored in the OS keychain.
6. In-App One-Click Update Installer
Clicking the update button in Settings → About (or the header update pill) downloads the native installer for your platform and architecture with live progress and launches it automatically, with automatic GitHub / Gitee mirror fallback for users in mainland China.
7. Resetting to Defaults
To reset all settings to factory defaults, quit SoloMD and delete the app data directory — %APPDATA%\app.solomd on Windows (or the data/ folder next to SoloMD.exe in portable mode), ~/Library/Application Support/app.solomd on macOS, or ~/.config/app.solomd on Linux. Your notes are ordinary files elsewhere and are never touched.
Comments & feedback
Comments live on GitHub Discussions — sign in once with your GitHub account.
Comments load from GitHub Discussions. If you see this message instead, the maintainer has not finished the one-time giscus.app setup yet — see web/COMMUNITY-SETUP.md.
Open on GitHub Discussions →