Skip to content
ObsiKO
English
Get the app

Settings & Themes

29 min readUpdated 2026-10-29
On this page

Time to turn ObsiKO into a workshop that's uniquely yours! From a single settings dialog, you can customize almost everything to your taste. ๐ŸŽจ

โ† Home: ObsiKO 101


Where was that setting again? ๐Ÿ”Ž

  • With more than twenty groups of settings, there's a search box at the top. Type whatever comes to mind โ€” font, dark, shortcut โ€” and only the matching settings stay.
  • It doesn't just match names: it also searches the "?" descriptions, the choices inside dropdowns, and group names. So a font name or a theme name finds the right row too.
  • Pick a group from the category list on the left to see just that one, and go back with All anytime.
  • Pressing Esc in the search box clears the search only (the dialog stays open). Press it again to close.

What should ObsiKO show at startup? ๐Ÿš€

  • Pick it in Settings โ–ธ Basics โ–ธ Startup screen โ€” Continue where I left off (default, your previous tabs) ยท Today's note (created then if it doesn't exist, and the offer to bring over yesterday's unfinished tasks follows) ยท Dashboard ยท Graph view ยท Codex view ยท A specific note.
  • Choose A specific note and a note list unfolds right below. Type a name or folder to narrow it down, then click.
  • If you open a different vault and that note isn't there, ObsiKO quietly continues where you left off (and tells you why).

Stepping away for a moment: screen lock ๐Ÿ”’

  • Turn on Settings โ–ธ Convenience โ–ธ Screen lock (biometrics/passcode) and a lock screen appears when you open the app and when you come back after more than a minute away. Perfect for leaving your table at a cafรฉ.
  • Creating a passcode, opening the app and turning the lock off all use the same big screen. When you create one, you type it twice on that one screen.
  • Turning it off asks for your current passcode (or device authentication) โ€” a lock you can switch off without proving anything isn't a lock.
  • If your device supports it, Touch ID on Mac ยท Face ID / Touch ID on iPhone & iPad ยท fingerprint on Android unlocks instantly. On iPhone and Android you can also fall back to your device passcode (PIN/pattern), and failing that it asks for the passcode you made.
  • โš ๏ธ The app passcode cannot be recovered if you forget it. Your note files stay as they are and remain readable in the folder.
  • Want to lock the moment you stand up? Run Lock screen now from the command palette.
  • ๐Ÿ“ฑ On an iPhone Duo, try Cover with a notebook cover when folded in the same Convenience section too. The moment you fold the Duo, a notebook cover covers the screen and your writing is hidden at once. If screen lock is on as well, when the lock kicks in it opens in the order cover โ†’ unfold โ†’ lock screen. โ†’ Platform Guide
  • โš ๏ธ This hides the screen โ€” it does not encrypt your files. Your notes stay in the vault folder as ordinary Markdown, so it can't stop someone who opens your computer and reads the files directly. For truly sensitive material, pair it with your device's disk encryption (FileVault and the like).

The Magic of Day and Night: Theme Mode ๐ŸŒ—

  • Pick the moody Dark Basic or the bright Light Basic at the top of the theme list โ€” the color presets follow right below them. There's no separate mode that switches on its own with your device's dark mode.
  • Your theme also colors the first screen you see when the app opens, so a dark theme never flashes white on launch. With a preset, that screen uses the preset's own color, so it flows straight into your notes. On a computer, the window has the same color from the moment it appears (the very first launch after installing uses the default theme's color). (On iPhone and Android, the very first moment before the app starts still follows your device setting for light or dark โ€” the operating system draws that one, so we drew it with the same emblem on the default theme's light and dark backgrounds.) For the logo animation at launch โ†’ Getting Started
  • ๐ŸŒ€ If motion bothers you: turn on your device's 'Reduce Motion' (on Windows, turn off 'Animation effects'; on Android, 'Remove animations') and ObsiKO follows along โ€” the startup logo, the page turn in Book view and the camera flight in Graph view stop, and theme effects (mist, shadows), dashboard animations and the Random Box's tumbling go quiet too.

One Click and Done: Color Presets ๐Ÿ’…

  • Don't want to fuss with details? Just pick one of ObsiKO's beautifully pre-tuned presets! (In particular, 'Cosmic Star' pairs perfectly with Graph View's space theme ๐ŸŒŒ โ†’ Graph View)
  • Of course, for pickier tastes, we've also opened up fine-tuning of each individual color โ€” background, text, highlight, and more!
  • Three themes with heading effects โœจ โ€” Golden (gold leaf on ebony: a dark brown-black background where gold headings lift off the page with a cream outline and soft shadow; body text in Gowun Batang) ยท Neon Sign (a night-street sign: purple-black background with hot-pink accents, cyan links, fluorescent-yellow highlighter, and headings that glow like sign bulbs; body text in NEXON Lv1 Gothic) ยท Ancient (a weathered old manuscript: parchment-toned background with bronze accents and verdigris links, and deep ink-brown headings; body text in Gyeonggi Batang).
  • Adding these made built-in themes able to carry heading effects (glow, outline, shadow) at all. Switch to a theme without them and they turn cleanly off, just like before. And the glow/outline/shadow in your own color presets now actually show up โ€” until now the values were saved but nothing drew them.
  • Spooky ๐ŸŽƒ โ€” a haunted-house Halloween theme. Bone-white text on pitch black, blood-red headings with a dark crimson haze, ghostly green links, and jack-o'-lantern orange highlights and tags. The edges of the page sink into darkness and mist drifts slowly along the bottom. Big headings (#) flicker now and then like a dying candle โ€” but never the line you're typing on (turn on Reduce Motion on your device to stop the mist and flicker). Body text uses Nanum Myeongjo.
    • Things you run into now and then ๐Ÿ‘ป โ€” faint cobwebs in the corners, a bookmark button beside the title that becomes a spider hanging on its thread (turn it on and it drops lower, blood-red), blood-red selection, a candle-flame cursor, stitched-scar dividers (---), tombstone quotes, claw-mark checkboxes, and a will-o'-the-wisp glow when you hover a link. Rest your hands and, once every minute or two, a pair of eyes opens in the darkness of the side margin and fades away (never while you type, and not on a phone held upright where the margin is too narrow). From midnight to 3 a.m. the darkness and mist grow thicker.
  • Theme touches โ€” Ink Wash ยท Autumn Field ยท Ancient ๐Ÿ‚: these three themes now get subtle touches like Spooky's too. Ink Wash has bamboo-leaf shadows that sway in the wind now and then over rice-paper grain, and a bookmark that's a seal stamp you press to ink. Autumn Field has maple-branch shadows and nodding rice stalks, with a maple-leaf bookmark that turns red when on. Ancient has colonnade shadows on weathered old paper and a leather-strap bookmark. Colors and shadows shift with the time of day, and the line you're writing is never covered (turn on Reduce Motion on your device to stop the movement).
  • Purliko ๐Ÿงถ โ€” a cozy theme that previews the colors of Purliko, a knitting-pattern app coming soon. Paper-colored background with cheese-yellow highlights, selection and checkboxes, caramel headings, sky-blue links and the rounded Gowun Dodum font. The bookmark is a striped tail hanging down from the top (it swishes and turns cheese-yellow when on), and the dividers are the wave from the cat's chest (___) and running stitches (---). When the left margin is wide enough, a cheese-cat silhouette sits quietly by a ball of yarn in the bottom corner โ€” it flicks its tail now and then while you rest, and hops with a heart when you tap it. In the bottom-right margin hangs a small knitted swatch on a needle that fills in stitch by stitch each time you pause โ€” the more you write that day, the further it gets (a heart when all eight rows are done, starting fresh the next day). The cat and the swatch don't appear on phones or narrow windows. Checking off a to-do pulls the checkbox tight like a knot, and the text cursor is a knitting needle with a cap on top.

Share the colors you crafted ๐ŸŽ

  • Press Export under Settings โ–ธ Theme โ–ธ Share color presets and all your saved color presets get packed into a single file (.oset). Move it to another device or gift it to a friend.
  • Import just asks you to pick a file โ€” it never overwrites your existing presets, adding the new ones alongside; on a name clash it appends (2) and keeps both.
  • The file contains colors only. It has nothing to do with your notes or vault, so it's safe to hand to anyone.

Building a Writing Environment That Fits You โœ๏ธ

  • Is the text too small? Do the lines feel cramped? Change the body font, size, line spacing, and letter spacing โ€” plus the width the text fills and its alignment โ€” however you like.
    • Letter spacing goes from tight (-5%) to wide (15%); the default is 2%.
    • The preview at the top of Settings โ–ธ Editor follows along the moment you change the font, size, line spacing, letter spacing, alignment, width or line numbers. On desktop and the web, with a roomy window, it stays pinned at the top while you scroll down through the settings.
  • Over 20 Korean-supporting fonts are bundled in! Pretendard, Maru Buri, Noto Sans/Serif KR, Nanum Square Neo, KoPubWorld Batang/Dotum, RIDIBatang, Seoul Hangang/Namsan, Gowun Dodum/Batang, S-Core Dream, NEXON Lv1 Gothic, Gyeonggi Batang, MapoFlowerIsland โ€” plus the monospaced D2Coding for code and the game-flavored Galmuri (pixel). If you love that pixel vibe, try pairing it with the 'Pangyo Midnight' preset. ๐Ÿ•น๏ธ
    • Fonts are downloaded when you pick them ๐Ÿ“ฅ: to keep the app light only three ship inside, and the rest fetch the first time you choose them (after that they stay on your device and work offline). So you only need the internet once per font โ€” and if it fails, it simply falls back to your previous font, so nothing breaks.
  • Don't see the font you want? You can load fonts installed on your device or import a font file (.ttf/.otf) directly (this varies a little by platform). โ†’ Platform Guide
  • There are also 3 diagram (Mermaid) styles to choose from โ€” classic, neo, and handDrawn! โ†’ Advanced Markdown

Tools for Deeper Focus While Writing ๐Ÿง˜

  • Typewriter scrolling: Turn it on and the line you're currently writing always stays centered on screen. Write on comfortably without having to look down!
  • Smart quotes: Automatically converts straight quotes into context-appropriate curly quotes (โ€˜ โ€™ โ€œ โ€) as you type (on by default). If you'd rather stick with straight quotes, turn it off here. โ†’ Markdown Basics
  • Vim mode: If you're used to Vim keybindings, try turning this on. (It's loaded only when needed, so the app stays light the rest of the time.)
  • Today's note folder: Set the folder for today's / this week's / this month's notes (2026-06-28.md ยท 2026-08-17 Week.md ยท 2026-08.md) โ€” shared by all three, blank = vault root. Weekly and monthly templates are set separately; leave them empty and you get just the date as a heading. โ†’ Calendar
  • Today's note title format: Choose the date shape used for the file name of today's note (default 2026-08-29). Pick a preset or type your own โ€” the resulting file name is previewed right below. Existing notes are never renamed, and the calendar still recognises the old names. โ†’ Calendar
  • Today's note template: Choose the template used for today's note. Click the field and the notes in your template folder drop down as a list โ€” just pick one (kept elsewhere? type a name and it searches the whole vault). Leave it empty for just the date heading. โ†’ Calendar
  • Writing reminder: Get a โ€œTime to write today's noteโ€ reminder on the days and time you choose; tap it to open today's note (or this week's note / review cards / the episode in progress โ€” the most recently edited web novel episode that hasn't been released yet). On phones and iPad it arrives even when the app is closed; on computers and the web, only while ObsiKO is open. โ†’ Calendar
  • Format toolbar: a floating button that holds formatting buttons like bold, headings and lists โ€” it appears on desktop, web and mobile alike, and on phones and tablets it floats above the keyboard. Choose Off / Auto (when the editor has focus) / Always. โ†’ Platform Guide
  • Writing log (Settings โ–ธ Saving): keeps a record of how a manuscript was written (when, and how much you typed yourself) inside the vault (.obsiko/writing-log), which you can replay as a summary and time-lapse from the story toolbar's Writing log button. The default is Web novel & book manuscripts only; you can switch to All notes or Off. Clear all writing logs lives here too. โ†’ 18-1 E-book & Web Novel Viewer

AI Agent Settings Have Moved into the Panel ๐Ÿ™

AI-related settings live in the options (โ‰ก) button in the AI Agent panel header, not in the settings dialog. Here's what you can turn on there.

  • Get answers as .md ยท Token optimization ยท Detailed completion report (a wrap-up of what changed and why)
  • Auto-capture personal memory ยท Save raw conversation log โ€” let the AI remember your taste and context long-term, and keep the raw transcript in your vault. โ†’ Personal Memory
  • Loops (collapsible) โ€” self-verification ยท completion gate ยท critic ยท iteration limit ยท picking the critic engine
  • Collaboration (collapsible) โ€” Ask another engine ยท Parallel drafts (gather answers from several engines and synthesize) ยท Parallel delegation (split the work and run it at once)
  • Git (collapsible) โ€” auto-commit ยท remote repo ยท push, and creating a GitHub repository, all in one place
  • Semantic (collapsible) โ€” the embedding backend and model for semantic search
  • Every other AI option, like the Codex tool connection, lives here too. โ†’ AI Agent

๐Ÿ’ก Some items only appear in the desktop app downloaded from the website (Mac/Windows) โ€” the Git and CLI-engine ones. On phones, the web and the Mac App Store version you'll only see what that device can actually use.

Quiet safeguards ๐Ÿ”

  • Show internet images automatically (Settings โ–ธ Editor): decides whether images added by an internet address load as soon as you open a note. When it is off they load only when you tap them, and until then no request reaches that image server at all โ€” so nobody else's server can tell when you opened a note. Images stored inside the vault are unaffected. On by default.
  • (Browser version) AI keys are stored inside this browser as they are. Tick โ€œDon't remember in this browserโ€ next to the key field and the key is erased when you close the tab โ€” always tick it on a shared computer.
  • (Browser version) Clear this browser's app data (Settings โ–ธ below Dictionary): wipes the settings, search index, version history, API keys and connections the browser version left here, then restarts the app. Notes in your vault folder are not deleted. Use it when you walk away from a shared computer. โ†’ Platform Guide

Sync between devices โ€” keep it on your GitHub ๐Ÿ”„

Settings โ–ธ Sync between devices keeps a vault in a private repository in your own GitHub account and matches it across your devices. There is no ObsiKO server; your notes live only on GitHub. It uses the same GitHub account you connected for web sharing (no account yet? You can create one for free in the approval window).

  • First device โ€” press โ€œKeep this vault on GitHubโ€; an explanation unfolds, and a second press goes through GitHub approval (paste the code), creates one private repository and uploads the vault.
  • Other devices โ€” โ€œGet a vault from another deviceโ€ฆโ€ lists the vaults kept on GitHub; picking one matches it with the vault open now. Same notes are merged, differing ones are kept as two copies.
  • After that it syncs automatically when you open the vault, shortly after saving, when you return to the app, and every 2 minutes while it is open (you can turn this off). Click โ€œSynced ยท 3m agoโ€ on the right of the status bar to sync now. Nothing runs while the app is closed.
  • If the same note was edited on both sides, different lines are merged; the same line keeps yours and leaves theirs as a copy next to it, and you get a notice (โ€œKeep mineโ€ / โ€œTake theirsโ€). Deleted notes go to the trash on the other device.
  • โ€œTurn offโ€ only disconnects this device. The GitHub repository and the vault files stay. App records (the .obsiko folder โ€” bookmarks, reading positions, routines) stay per device by default, but โ€œAlso sync app recordsโ€ moves them too (received records appear after reopening the app).
  • โš ๏ธ AI memories and raw chat logs always go up, whatever that option says. They live in _ObsiKO/memory and _ObsiKO/chats as ordinary notes, so they are treated like everything else in the vault. If you would rather not upload them, move that folder out of the vault or turn the logging off. โ†’ Personal Memory
  • What never goes up: the .obsidian, .trash, .git and node_modules folders, system files like .DS_Store, any file over 50MB, and the README.md at the top of the vault (that one describes the repository, so it isn't treated as a note).
  • If a great many files changed at once, GitHub's hourly limit can be reached. Sync doesn't stop: it uploads what it can and tells you โ€œ{n} files will follow in {min} minโ€, then finishes on its own once the limit resets.
  • It stops before it deletes. A brief failure to read GitHub used to look like โ€œthe other device deleted everythingโ€, so ObsiKO now tells โ€œcould not readโ€ apart from โ€œreally emptyโ€. If it cannot read, it deletes nothing and simply stops (the same guard applies in the other direction).
  • If several files are about to go, it asks first. A card appears in Settings โ–ธ Sync between devices with โ€œKeep both, delete nothingโ€ or โ€œDelete anywayโ€ (automatic syncing rests until you choose). Deletions only ever move files to the trash โ€” if they cannot go to the trash, sync stops instead. โ†’ Trash

โš ๏ธ By GitHub rules this approval also grants access to your other private repositories (ObsiKO only touches the one it made). The Git item in the AI agent options above (auto-commit ยท push) is a separate feature.

๐ŸŒ The browser version does not offer sync between devices โ€” so that a token with repository access is never kept inside a browser. Turn sync on in the desktop or phone app instead (the browser's settings only show this note). Sharing to the web still works in the browser. โ†’ Platform Guide

(Website Desktop App Only) Letting Another AI App Read Your Vault ๐Ÿ”Œ

This is only in the desktop app downloaded from the website (Mac/Windows). The Mac App Store version, phones and the web don't have this setting.

Want to tell another AI app โ€” the Claude desktop app, say โ€” "go look through my notes"? Turn on 'External AI apps'.

  • Switch it on and per-app connection cards appear. For Claude Desktop, Cursor, VS Code, Antigravity, Claude Code, and the Codex CLI it's one click on [Connect] โ€” then just quit that app completely and reopen it. (If an app isn't installed you'll see 'Not installed' with a download link, and a [Disconnect] button sits in the same spot when you're done.)
  • For any app not in the list, unfold 'Connect another app manually (advanced)' below the cards and paste the config snippet into that app's MCP settings.
  • Reading only. Only search-and-read tools are exposed โ€” there is no writing or deleting at all. The other app can read a found note all the way through (long notes in parts), and clicking an 'Open in ObsiKO' link in its answer opens that note in ObsiKO โ€” in the right window even with several vaults open. The example questions under the cards are a good place to start. It also shares the semantic search index ObsiKO has already built, so "find notes about something like this" works instantly in the other app too. Very large notes (a tens-of-MB log, say) are streamed with no size cap, so they can be searched and read to the end (only the amount shown at once is split).
  • Korean language tools come along ๐Ÿ“–: the other app can look up words in the ObsiKO Korean Dictionary (the National Institute of Korean Language's Standard Korean Language Dictionary and Urimalsam), fit a replacement word to the original's inflection and particles, and check text with the ObsiKO spell checker โ€” try asking "check the spelling of this paragraph" or "confirm this word's meaning in the Korean dictionary". A dictionary lookup sends at most one word, and the spell check sends the text being checked to the ObsiKO language server (which does not store it). These tools don't read your vault.
  • You choose which vaults to open up. Turning this on shows an Vaults opened to external apps list. From the window holding the vault you want, press [Open this window's vault] and it joins the list (name it whatever you like). Moving between windows never changes the list โ€” it won't quietly follow whichever window you're looking at.
  • You can open several vaults (up to 3). Each one appears separately in the other app, so a single conversation can do "find it in Work and write it up in Novel". The cap of 3 exists because the tool list grows with each vault, which makes the other app harder to use.
  • The switch on a row pauses one vault; [Remove] also cleans up the entries in apps you connected. The big switch at the top turns everything off at once (the list stays) and restores it when you turn it back on.
  • If you move or rename a vault, it stops being readable for a moment โ€” open it again in ObsiKO and press [Connect] once more. ๐Ÿ‘
  • It's off by default. Turn it on only when you need it.

๐Ÿ”’ Turning it off really does cut the connection. It doesn't matter if the old config is still sitting in the other app โ€” the side that accepts the connection checks this switch every time it starts, and even an already-running connection refuses the very next request once you switch it off, and cuts itself off within seconds. of you flipping the switch.

That said, 'read-only' means your notes can't be changed โ€” not that they stay secret. The other app does whatever it likes with what it reads. If there are notes you want hidden, mark them ahead of time. โ†’ AI Sources & Privacy

Perfecting Your Writing: Dictionary & Spell Check ๐Ÿ“–

  • In Settings โ–ธ Dictionary you can switch the 13 dictionaries shown in the dictionary panel on or off (encyclopedia, ObsiKO Korean Dictionary, Korean, Hanja, English and more) and add an offline dictionary pack you converted yourself (.ndjson/.gz โ€” none comes with the app) with Import pack. The National Institute of Korean Language's dictionaries (Standard Korean Dictionary, Urimalsam) are shown by the ObsiKO Korean Dictionary without a key.
  • Word meanings in reading mode is also switched here (on by default) โ€” rest the mouse on a word in reading mode to see a one-line meaning. โ†’ 06 Korean Writing Tools
  • Your own spell-check exception words aren't set here: in the Spell check panel, press [Add exception] on a flagged word. โ†’ Korean Writing Tools

Voice Settings (Read Aloud) ๐Ÿ”Š

  • No setup needed just to listen โ€” 'Read Note Aloud' in the command palette plays instantly with your device voice (free). The settings below are for creating audio files (AI narration); a Gemini key also works on its free quota.
  • You pick the Device voice here too โ€” set one per language of the text and hear it first with [Preview] (only voices installed for that language show up; if your device has no voices at all, this row is hidden). You can also switch it on the playback bar while it's reading. To get more of them, download them in your device's system settings โ€” Mac/iPhone: Accessibility โ–ธ Spoken Content โ–ธ Voices; Android: Settings โ–ธ Accessibility โ–ธ Text-to-speech โ–ธ voice data. They appear in the list after you restart the app. The ? on the playback bar says the same thing (for the device you're on).
  • You can set the default voice for AI read-aloud, per provider (OpenAI, Gemini). Separate from switching it on the fly in the playback bar, the voice you pick here becomes the default. โ†’ AI Agent
  • Precise read-aloud highlight sync: Matches the 'highlight the sentence being read' feature exactly to per-sentence timestamps (uses a Whisper re-transcription โ€” requires an OpenAI key, at extra cost). It's fine to leave this off most of the time, since the default sync tracks along pretty well anyway.

In a Language You're Comfortable With (UI Language) ๐ŸŒ

  • More comfortable in Korean, or English, Japanese, or Chinese (Traditional or Simplified)? Switch to whichever language suits you, anytime!

Shortcut Settings for Keyboard Ninjas โŒจ๏ธ

  • The default shortcuts don't feel natural to you? No worries! Just press and hold your preferred key combo (to record it), and you can change absolutely everything to your liking. โ†’ For details, see Keyboard Shortcuts

๐ŸŽจ App Icon โ€” Seasonal Icons

In Settings โ–ธ Basics โ–ธ App icon you can switch to a seasonal icon (iPhone ยท iPad ยท Mac ยท Windows).

  • Hangul Day ๐Ÿ‡ฐ๐Ÿ‡ท: a red-and-blue taegeuk pattern. If you use ObsiKO in Korean, from October 1 to 15 iPhone and iPad suggest it on a card first, and on Mac and Windows the Dock / taskbar icon changes while the app is running during that time. Once Hangul Day has passed, it asks whether to Switch back. (In other languages it shows only if you've already switched to it.)
  • Halloween ๐ŸŽƒ: a purple gradient over the top of the usual icon, two crooked horns and three round eyes each looking a different way. If you use ObsiKO in a language other than Korean, from October 18 to 31 iPhone and iPad suggest it on a card (it changes only when you press [Switch]), and in the first week of November it asks whether to switch back โ€” only if you switched from the card. On Mac and Windows the Dock / taskbar icon changes during that time and goes back when you quit. In Korean it isn't suggested โ€” pick it yourself in Settings.
  • You can pick any of these in Settings anytime, even out of season (the Hangul Day icon in Korean only).

๐Ÿ’ก Feature Tips โ€” Now and Then, a Nudge

As you write, ObsiKO occasionally suggests a feature that fits what you're doing, in a small card at the bottom right of the editor. Grow a list to five to-dos and it points to the Outline's To-dos tab; add a to-do with a date and it points to the Calendar; reach a web-novel episode's character goal and it suggests the Writing Helper's Tighten tab. In an empty note, a Pick an outline chip appears in the chip row under the title.

  • Show me opens the feature right away. Later rests that tip for a week.
  • It stays out of your way: never while you're typing or composing Korean, and at most once every 20 minutes (and twice per app launch). Features you've already used aren't suggested, and the same tip shows at most twice.
  • To turn it off, use Turn off tips on the card or Settings โ–ธ Basics โ–ธ Feature tips. Reset all guides brings the tips back from the start.

๐Ÿ“‹ What Else Is in the Settings Dialog? (The Full List)

The settings dialog is split into collapsible sections โ€” click a heading to expand it. Here's a sweep through everything, including what we haven't covered above.

Section What you can do here
Basics The app's display language (System (follow the device language) ยท ํ•œ๊ตญ์–ด ยท English ยท ๆ—ฅๆœฌ่ชž ยท ็น้ซ”ไธญๆ–‡ ยท ็ฎ€ไฝ“ไธญๆ–‡), weather location, picking your startup screen (see above), the vault change log โ†’ Vault Log, app icon (on supported devices only โ€” see above), feature tips (see above), replaying the guides you saw on first launch (main screen ยท editor ยท mind map) and Reset all guides
Today's note Unique note folder, the today's note folder (shared with weekly and monthly notes), title format and today / weekly / monthly templates, offer task rollover, writing reminder (days, time, what it opens) โ†’ Calendar
Editor The preview at the top, font, size, line spacing, letter spacing, body width and alignment; line numbers, format toolbar, typewriter scrolling, smart quotes, auto symbol replace, code block line numbers, show formatting marks, collapse frontmatter (properties), load installed fonts ยท import font files (ttf/otf), spell check (red underline), comment (%%) display, show internet images automatically (see the section above), Mermaid style
Theme Dark Basic/Light Basic, color presets, picking 11 colors yourself (accent, background, text, links, highlighter, headings, sidebar background, quotes, code, tags, list markers), heading effects (glow ยท outline ยท shadow), save colors, sharing color presets, reset theme colors
Shortcuts Record and reset the key combo for every command โ†’ Keyboard Shortcuts
Calendar First day of the week, how files are sorted by date, public holidays, ledger amount badges, external calendar (ICS) subscriptions, export events (.ics) โ†’ Calendar
Task statuses Defining checkbox symbols (x, /, -, ...) and the global task filter โ†’ Calendar
Dictionary Switch the 13 dictionaries on or off (only checked ones show in the dictionary panel โ€” NIKL dictionaries via the ObsiKO Korean Dictionary, no key), import an offline dictionary pack (one you converted), clearing the dictionary cache โ†’ Korean Writing Tools ยท (browser version only) clear this browser's app data
Image search Save full resolution (on: downloads the original size; off: saves at about 600px), your own Pixabay ยท Pexels ยท Giphy API keys (search works without them)
Voice settings Device voice (per language ยท preview), the default voice per provider, and precise read-aloud sync
Saving Adjusting the autosave interval, Writing log (manuscripts only ยท all notes ยท off) ยท Clear all writing logs (see above), (desktop) auto backup (daily) ยท open the backup folder
System integration (Android 14+) Register ObsiKO as your default notes app โ†’ Platform Guide
External AI apps (Website desktop app) Let other AI apps read your vault โ€” see the section above
Web sharing GitHub connection status, disconnect, and everything you published (open ยท stop sharing) โ†’ Export
Sync between devices Keep the vault in a private GitHub repository and match it across devices โ€” see the section above
Web Clipper The folder clips land in, offline copy (save images & paper PDFs into the vault), the bookmarklet address, RSS subscriptions (auto-clip new posts) โ†’ Web Clipper
Import Bring a Notion ZIP, an Evernote .enex, a Bear ZIP, a Logseq ZIP, a Roam ZIP, a Markdown folder/ZIP or Apple Notes into your vault โ€” see the section below
Convenience Semantic search index, screen lock (biometrics/passcode), Vim mode, kind suggestion chips, template chips on empty notes, link previews, swipe from the screen edge to open the sidebar, auto-empty trash โ†’ Trash, keep cloud files downloaded ยท pre-download entire vault, (iPhone/iPad) Find notes with Siri & Spotlight ยท transcribe recordings into a new note, (iPhone Duo) Cover with a notebook cover when folded ยท Cover style (shown only when it's on) โ†’ Platform Guide
Status bar items Which of file path (on by default), total characters (the note as written, properties and Markdown symbols included), length goal (web novel episodes only), word count, paragraph count, link count, backlink count, reading time, manuscript pages, file size or cursor position appear in the bottom status bar (in a narrow window the trailing ones fold away automatically) ยท Total character count with or without spaces ยท Goal (characters) and Length goal count (the goal for one web novel episode โ€” 5,000 with spaces by default; clicking the status bar chip changes it too) ยท Skip comments (on by default โ€” %%notes%% don't count toward the total)
About The current version, check for updates ยท (website desktop app) check for updates on launch, font licenses ยท Open source licenses, homepage link, Last startup (how long screen setup, opening the vault and reading the note list took last launch โ€” for when startup feels slow), (iPhone) Control Center recording log
Sidebar & toolbars Hide buttons or change their order in the sidebar and toolbars (hidden features still work from the command palette and shortcuts). On iPhone Duo you also pick the Side rail favorites here (the favorites capsule in the strip, up to the first 7) โ†’ Keyboard Shortcuts ยท Platform Guide
Get the mobile app (Desktop) Point your phone camera at the QR code and it goes straight to the App Store on iPhone/iPad or Google Play on Android
Get the desktop app (Phone/tablet) Open the homepage, or use โ€œSend the linkโ€ to mail or message yourself the address and open it on the computer

Bringing notes over from another app ๐Ÿ“ฆ

Settings โ–ธ Import offers seven of them. If you're just starting, you can also tap Import from another app on the welcome screen โ€” pick the app, and you'll see a line or two on how to export from it, then choose the file or folder right there.

Every import creates a new folder inside your vault, so the notes you already have are never touched. Import the same thing twice and you simply get another folder (like Bear 2) โ€” nothing is overwritten. If no vault is open yet, your default storage opens after you pick the file and the notes go there. (For a very large export โ€” over 20,000 files or 2 GB in total โ€” please split it up.)

  • Notion โ€” export from Notion as Markdown & CSV and drop the ZIP in. We strip the UUID off each file name, turn internal links into [[wikilinks]], and convert database CSVs into tables.
  • Evernote โ€” drop in the .enex Evernote gives you. An .enex isn't a folder: it's a single XML file holding notes and attachments together, so it can't be read as-is and must go through this conversion. Body text, attached images, tags, creation dates and source URLs all come across, and task checkboxes survive too. (Parts you locked/encrypted in Evernote can't be brought over โ€” we tell you how many were skipped.)
  • Bear โ€” in Bear, export as Markdown, then zip that folder and drop it in.
  • Logseq ยท Roam Research โ€” for both, export as Markdown and drop the ZIP in. Outliner-specific notation is rewritten into ObsiKO's: TODO / LATER become [ ], DOING / NOW become [/], DONE becomes [x]; key:: value properties at the top of a note move into frontmatter; {{embed [[note]]}} becomes an ![[note]] embed; and #[[multi word tag]] becomes [[multi word tag]]. Journal files (2026_08_05.md) are renamed to match today's notes: 2026-08-05.md.
    • Nested bullets are left exactly as they are โ€” that structure is information you brought from the outliner. ((block refs)) are kept too, and we tell you how many there were at the end.
    • Only .md export ZIPs are supported. Roam's JSON/EDN backups and Logseq's DB graphs are a different format altogether, so they're out of scope.
  • Markdown files ยท another app's vault โ€” for an Obsidian vault or any folder of .md files, pick the whole folder (desktop, Chrome, recent Safari) or zip it up and drop it in. The contents are copied byte for byte; only settings and clutter like .obsidian, .DS_Store and __MACOSX are left out. If your vault already has a note with the same name, we add the new folder's name to just those links, so an imported [[link]] never points at the wrong note.
  • Apple Notes โ€” drop in the folder you exported from Notes (or a ZIP of it). It's copied as-is, just like Markdown files.

Why does Bear need an 'export' first? ๐Ÿป

Bear keeps notes in its own database, so there's no .md folder for ObsiKO to open until you export once from Bear.

The exported folder is mostly readable as-is. There are just three notations only Bear uses that look different in ObsiKO โ€” and those are all the import fixes.

Bear notation If you just open it After importing
::highlight:: The colons show up as plain text ==highlight==
~strikethrough~ A single tilde means subscript in ObsiKO, so the meaning silently changes ~~strikethrough~~
#multi word# Only #multi becomes a tag and word# is left over #multi-word

Nested tags like #parent/child already work, so they're left alone. Your image and attachment folders and headings stay as they are, and nothing inside a code block is touched (so std::vector doesn't turn into a highlight ๐Ÿ˜„).

๐Ÿ’ก Sections your device can't use simply don't appear (e.g. 'System integration' is Android-only; 'External AI apps' is only in the desktop app from the website (Mac/Windows); 'Web Clipper' is only in the desktop and phone apps โ€” not the browser version). Nothing's broken if you don't see one! ๐Ÿ˜Œ


โ† Previous: Trash ยท Home ยท Next: Keyboard Shortcuts โ†’