Obsidian Settings

Settings

Upon opening Obsidian for the first time, Obsidian comes with the following .json files in the .obsidian folder:

In app.json

Default:

{}

In appearance.json

Default:

{}

In core-plugins.json

Default:

{
  "file-explorer": true,
  "global-search": true,
  "switcher": true,
  "graph": true,
  "backlink": true,
  "canvas": true,
  "outgoing-link": true,
  "tag-pane": true,
  "footnotes": false,
  "properties": true,
  "page-preview": true,
  "daily-notes": true,
  "templates": true,
  "note-composer": true,
  "command-palette": true,
  "slash-command": false,
  "editor-status": true,
  "bookmarks": true,
  "markdown-importer": false,
  "zk-prefixer": false,
  "random-note": false,
  "outline": true,
  "word-count": true,
  "slides": false,
  "audio-recorder": false,
  "workspaces": false,
  "file-recovery": true,
  "publish": false,
  "sync": true,
  "bases": true,
  "webviewer": false
}

In workspace.json

Default:

{
  "main": {
  "id": "b6880eb90074385c",
  "type": "split",
  "children": [
    {
      "id": "f2536fe24ce8f8f3",
      "type": "tabs",
      "children": [
        {
          "id": "8c67c3da817ad3fb",
          "type": "leaf",
          "state": {
            "type": "empty",
            "state": {},
            "icon": "lucide-file",
            "title": "New tab"
            }
          }
        ]
      }
    ],
    "direction": "vertical"
  },
  "left": {
    "id": "cfb42b5c145d9a51",
    "type": "split",
    "children": [
      {
        "id": "b024ba4d74cf81b9",
        "type": "tabs",
        "children": [
          {
            "id": "db94200a8bb8b207",
            "type": "leaf",
            "state": {
              "type": "file-explorer",
              "state": {
                "sortOrder": "alphabetical",
                "autoReveal": false
              },
              "icon": "lucide-folder-closed",
              "title": "Files"
            }
          },
          {
            "id": "85f58db3627519a6",
            "type": "leaf",
            "state": {
              "type": "search",
              "state": {
                "query": "",
                "matchingCase": false,
                "explainSearch": false,
                "collapseAll": false,
                "extraContext": false,
                "sortOrder": "alphabetical"
              },
              "icon": "lucide-search",
              "title": "Search"
            }
          },            
          {
            "id": "3f0ae3be709c1ade",
            "type": "leaf",
            "state": {
              "type": "bookmarks",
              "state": {},
              "icon": "lucide-bookmark",
              "title": "Bookmarks"
            }
          }
        ]
      }
    ],
    "direction": "horizontal",
    "width": 300
  },
  "right": {
    "id": "3b69008ddf2e7093",
    "type": "split",
    "children": [
      {
        "id": "3658c0c4a5f03768",
        "type": "tabs",
        "children": [
          {
            "id": "a47548cd07b0d49f",
            "type": "leaf",
            "state": {
              "type": "backlink",
              "state": {
                "collapseAll": false,
                "extraContext": false,
                "sortOrder": "alphabetical",
                "showSearch": false,
                "searchQuery": "",
                "backlinkCollapsed": false,
                "unlinkedCollapsed": true
              },
              "icon": "links-coming-in",
              "title": "Backlinks"
            }
          },
          {
            "id": "298f8d5998711aa7",
            "type": "leaf",
            "state": {
              "type": "outgoing-link",
              "state": {
                "linksCollapsed": false,
                "unlinkedCollapsed": true
              },
              "icon": "links-going-out",
              "title": "Outgoing links"
            }
          },
          {
            "id": "1df0e649195d5836",
            "type": "leaf",
            "state": {
              "type": "tag",
              "state": {
                "sortOrder": "frequency",
                "useHierarchy": true,
                "showSearch": false,
                "searchQuery": ""
              },
              "icon": "lucide-tags",
              "title": "Tags"
            }
          },
          {
            "id": "a6f2ee98d3cc2ce5",
            "type": "leaf",
            "state": {
              "type": "all-properties",
              "state": {
                "sortOrder": "frequency",
                "showSearch": false,
                "searchQuery": ""
              },
              "icon": "lucide-archive",
              "title": "All properties"
            }
          },
          {
            "id": "2d05e9244917516d",
            "type": "leaf",
            "state": {
              "type": "outline",
              "state": {
                "followCursor": false,
                "showSearch": false,
                "searchQuery": ""
              },
              "icon": "lucide-list",
              "title": "Outline"
            }
          }
        ]
      }
    ],
    "direction": "horizontal",
    "width": 300,
    "collapsed": true
  },
  "left-ribbon": {
    "hiddenItems": {
      "switcher:Open quick switcher": false,
      "graph:Open graph view": false,
      "canvas:Create new canvas": false,
      "daily-notes:Open today's daily note": false,
      "templates:Insert template": false,
      "command-palette:Open command palette": false,
      "bases:Create new base": false
    }
  },
  "active": "8c67c3da817ad3fb",
  "lastOpenFiles": []
}

Options

General

Automatic updates

Turn this off to prevent the app from checking for updates.

Default: true

Language

Change the display language. Learn how to add a new language to Obsidian.

Default: English

Available languages

Language code	Language name	Native name
am	Amharic	አማርኛ
ar	Arabic	العربية
be	Belarusian	Беларуская мова
bn	Catalan	català
cs	Czech	čeština
da	Danish	Dansk
de	German	Deutch
en	English	English
en-GB	English (GB)	English (GB)
es	Spanish	Español
fa	Persian	فارسی
fr	French	Français
ga	Irish	Gaeilge
he	Hebrew	עברית 🇮🇱
hu	Hungarian	Magyar
id	Indonesian	Bahasa Indonesia
it	Italian	Italiano
ja	Japanese	日本語
kh	Khmer	ខ្មែរ
ko	Korean	한국어
lv	Latvian	Latviešu
ms	Malay	Bahasa Melayu
ne	Nepali	नेपाली
nl	Dutch	Nederlands
no	Norwegian	Norsk
pl	Polish	Polski
pt	Portuguese	Português
pt-BR	Brazilian Portuguese	Português do Brasil
ro	Romanian	Română
ru	Russian	Русский
sq	Albanian	Shqip
th	Thai	ไทย
tr	Turkey	Türkçe
uk	Ukrainian	Українська
uz	Uzbek	oʻzbekcha
vi	Vietnamese	Tiếng Việt
zh	Chinese (Simplified)	简体中文
zh-TW	Chinese (Traditional)	繁體中文

Advanced

Notify if startup time takes longer than expected

Diagnose issues with your app by seeing what is causing the app to load slowly.

Default: off

My settings

I turned this on.

Editor

Always focus new tabs

When you open a link in a new tab, switch to it immediately.

In app.json

Only written to app.json upon update.

Default:

  "focusNewTab": true

Default view for new tabs

The default view that a new markdown tab gets opened in.

• Editing view ("source")
• Reading view ("preview")

In app.json

Only written to app.json upon update.

Default:

  "defaultViewMode": "source"

Default editing mode

The default editing mode a new tab will start with.

• Live Preview
• Source Mode

In app.json

Only written to app.json upon update.

Default:

  "livePreview": true

Show editing mode in status bar

Show the editing mode toggle in the status bar.

Default: true

Display

Readable line length

Limit maximum line length. Less content fits onscreen, but long blocks of text are more readable.

In app.json

Only written to app.json upon update.

Default:

  "readableLineLength": true

Strict line breaks

Markdown specs ignore single line breaks in reading view. Turn this off to make single line breaks visible.

In app.json

Only written to app.json upon update.

Default:

  "strictLineBreaks": false

Properties in document

Choose how properties are displayed at the top of notes. Select “source” to show properties as raw YAMAL.

• Visible (visible)
• Hidden (hidden)
• Source (source)

In app.json

Only written to app.json upon update.

Default:

  "propertiesInDocument": "visible"

Fold heading

Lets you fold all content under a heading.

In app.json

Only written to app.json upon update.

Default:

  "foldHeading": true

Note: Even if set to false, the carat will still appear next to the heading upon hover. It just won’t be clickable.

Fold indent

Lets you fold part of an indentation, such as lists.

In app.json

Only written to app.json upon update.

Default:

  "foldIndent": true

Note: Even if set to false, the carat will still appear next to the heading upon hover. It just won’t be clickable.

Line numbers

Show line numbers in the gutter.

In app.json

Only written to app.json upon update.

Default:

  "showLineNumber": false

My settings

I set this to true.

Indentation guides

Show vertical relationship lines between list items.

In app.json

Only written to app.json upon update.

Default:

  "showIndentGuide": true

Right-to-left (RTL)

Sets the default text direction of notes to right-to-left.

In app.json

Only written to app.json upon update.

Default:

  "rightToLeft": false

Behavior

Spellcheck

Turn on the spellchecker.

In app.json

Only written to app.json upon update.

Default:

  "spellcheck": true

Spellcheck languages

Choose the languages for the spellchecker to use.

Available languages

• Afrikaans
• Albanian
• Armenian
• Bulgarian
• Catalan
• Croatian
• Czech
• Danish
• Dutch
• English
• English (Australia)
• English (Canada)
• English (United Kingdom)
• English (United Kingdom)(oxendict)
• English (United States)
• Estonian
• Faroese
• French
• French (France)
• German
• German (Germany)
• Greek
• Hebrew
• Hindi
• Hungarian
• Indonesian
• Italian
• Italian (Italy)
• Korean
• Latvian
• Lithuanian
• Norwegian Bokmål
• Persian
• Polish
• Portuguese
• Portuguese (Brazil)
• Portuguese (Portugal)
• Romanian
• Russian
• Serbian
• Serbo-Croatian
• Slovak
• Slovenian
• Spenish
• Spanish (419)
• Spanish (Argentina)
• Spanish (Mexico)
• Spanish (Spain)
• Spanish (United States)
• Swedish
• Tajik
• Tamil
• Turkish
• Ukrainian
• Vietnamese
• Welsh

Auto-pair brackets

Pair brackets and quotes automatically.

In app.json

Only written to app.json upon update.

Default:

  "autoPairBrackets": true

Auto-pair Markdown syntax

Pair symbols automatically for bold, italic, code, and more.

In app.json

Only written to app.json upon update.

Default:

  "autoPairMarkdown": true

Smart lists

Automatically set indentation and place list items correctly.

In app.json

Only written to app.json upon update.

Default:

  "smartIndentList": true

Indent using tabs

Use tabs to indent by pressing the “Tab” key. Turn this off to indent using 4 spaces.

In app.json

Only written to app.json upon update.

Default:

  "useTab": true

Bug

Setting useTab to false does not disable tab indentation. It only adds the ability to indent with 4 spaces as well. While the description is technically accurate, it does not match what the property name or user expectation implies.

Indent visual width

Number of spaces a tab character will render as.

In app.json

Only written to app.json upon update.

Default:

  "tabSize": 4

Changing tab size to a number not supported by the slider

While the tab size slider only supports values between 2 and 8, you can set the value to a different number in app.json directly and it will render correctly. Numbers below 0 (such as -1 or -2) will render a tab size of 8 regardless of the number.

Advanced

Convert pasted HTML to Markdown

Automatically convert HTML to Markdown when pasting and drag-and-drop from web pages. Use Ctrl/Cmd+Shift+V to paste HTML without converting.

In app.json

Only written to app.json upon update.

Default:

  "autoConvertHtml": true

Warning

When autoConvertHtml is false, pressing Ctrl/Cmd+Shift+V will not convert pasted HTML to Markdown.

Vim key bindings

Use Vim key bindings when editing.

In app.json

Only written to app.json upon update.

Default:

  "vimMode": false

When turning vim key bindings on, you will receive this popup:

Confirm entering Vim mode

Vim mode is for efficient text editing but can be quite counter-intuitive. If you’re not familiar with Vim, this option might make it look like Obsidian has stopped working.

To verify that you know your way around Vim, please enter the command to quit Vim without saving below:

Files and links

Default file to open

Choose which file to open when the app starts.

• Last opened ("")
• New note ("new")
• Specific file ("file:")
• Daily note ("daily")

In app.json

Only written to app.json upon update.

Default:

  "openBehavior": false

File to open

Select a specific file to open by default.

This setting only appears when openBehavior is set to "file:". The selected file’s path is appended to "file:" in app.json.

Default location for new notes

Where newly created notes are placed.

• Vault folder ("root")
• Same folder as current file ("current")
• In the folder specified below ("folder")

In app.json

Only written to app.json upon update.

Default:

  "newFileLocation": "root"

Folder to create new notes in

Newly created notes will appear in this folder.

This setting only appears when newFileLocation is set to "folder". The selected folder is stored in:

 "newFileFolderPath": "Your folder name"

Note: newFileFolderPath retains its value even when a different option is selected in the dropdown, but only takes effect when newFileLocation is set to "folder".

Default location for new attachments

Where newly added attachments are placed.

• Vault folder “/”
• Same folder as the current file ("./")
• In subfolder under current folder ("./your-folder-name")
• In the folder specified below ("your-folder-path")

In app.json

Only written to app.json upon update.

Default:

  "attachmentFolderPath": "/"

Subfolder name

If your file is in “vault/folder”, and you set subfolder name to “attachments”, attachments will be saved to “vault/folder/attachments”.

This setting only appears when “In subfolder under current folder” is selected in the dropdown.

If no folder is specified, attachmentFolderPath will default to "./attachments".

Attachment folder path

Place newly created attachment files, such as images created via drag-and-drop or audio recordings, in this folder.

This setting only appears when “In the folder specified below” is selected in the dropdown.

If no folder is specified, attachmentFolderPath will default to "attachments".

My settings

I selected “Same folder as current file”.

Links

New link format

What links to insert when auto-generating internal links.

• Shortest path when possible ("shortest")
• Path from current file ("relative")
• Path from vault folder ("absolute")

In app.json

Only written to app.json upon update.

Default:

  "newLinkFormat": "shortest"

Automatically update internal links

Turn off to be prompted to update links after renaming a file.

In app.json

Only written to app.json upon update.

Default:

  "alwaysUpdateLinks": false

When renaming a link, you will receive this popup:

Update links

Do you want to update internal links that link to this file?

This will affect [#] in [#] file.

[Always update] [Just once] [Do not update]

If “Always update” is selected, "alwaysUpdateLinks" is set to true.

Bug

Closing the dialog will proceed with renaming the file, without updating internal links.

My settings

I turned this on.

Use Wikilinks

Auto-generate Wikilinks for links and

Transclude of images

instead of Markdown links and images. Disable this option to generate Markdown links instead.

In app.json

Only written to app.json upon update.

Default:

  "useMarkdownLinks": false

Show all file types (Links)

Show files with any extension even if Obsidian can’t open them natively, so you can link to them and see them in File Explorer and Quick Switcher.

In app.json

Only written to app.json upon update.

Default:

  "showUnsupportedFiles": false

My settings

I turned this on.

Trash

Confirm file deletion

Ask before deleting a file.

In app.json

Only written to app.json upon update.

Default:

  "promptDelete": true

If "promptDelete" is true, you will receive this popup when you try to delete a file:

Delete file

Are you sure you want to delete “your-file-name”?

(Information about happens to the file if deleted is placed here.)

• Do not ask again [Delete] [Cancel]

Checking “Do not ask again” before clicking “Delete” will cause "promptDelete" to be set to false.

Deleted files

What happens to a file after you delete it.

• Move to system trash ("system") The deletion prompt will say: “It will be moved to your system trash.”
• Move to Obsidian trash (.trash folder) ("local") The deletion prompt will say: “It will be moved to your Obsidian trash, which is located in the “.trash” hidden folder in your vault.”
• Permanently delete ("none") The deletion prompt will say: “This file will be permanently deleted.”

In app.json

Only written to app.json upon update.

Default:

  "trashOption": "system"

Deleting to .trash when it does not exist

For vaults synced with iCloud, the first deletion may create the .trash folder without moving the file. A second deletion is required. This is caused by iCloud intercepting the delete operation, not an Obsidian bug.

My settings

I set this to “Move to Obsidian trash (.trash folder)“

Advanced

Excluded files

Excluded files will be hidden in Search, Graph View, and Unlinked Mentions, less noticeable in Quick Switcher and link suggestions.

In app.json

Only written to app.json upon update.

Default:

  "userIgnoreFilters": []

When clicking “Manage”, you will receive this popup:

Excluded files

No excluded filter is applied right now. Add one below.

Override config folder

Use a different config folder than the default one. Must start with a dot.

Allow URI callbacks

Enable the use of x-callback-url through x-success or x-error when handling Obsidian URIs. Learn more

In app.json

Only written to app.json upon update.

Default:

  "uriCallbacks": false

Rebuild vault cache

Rebuilding the cache could take a few seconds to a few minutes depending on the size of your vault. Learn more

Appearance

Base color scheme

Choose Obsidian’s default color scheme.

• Dark ("obsidian")
• Light ("moonstone")
• Adapt to system ("system")

In appearance.json

Only written to appearance.json upon update.

Default:

  "theme": "system"

Accent color

Choose the accent color used throughout the app.

In appearance.json

Only written to appearance.json upon update.

Default:

  "accentColor": ""

When unspecified, the accent color is 8A5CF5.

Themes

Manage installed themes and browse community themes.

If there is no “themes” folder in Obsidian, either installing a new theme or clicking the folder icon will create one.

In appearance.json

Only written to appearance.json upon update.

Default:

  "cssTheme": ""

About the Default theme

According to the theme’s page in the community themes, the Default theme was made by Obsidian. It cannot be uninstalled, and only has a simple description on the theme page:

A simple theme designed to feel intuitive across all platforms. Supports light and dark mode.

Interface

Inline title

Display the filename as an editable title inline with the file contents.

In app.json

Only written to app.json upon update.

Default:

  "showInlineTitle": true

My settings

I turned this off.

Show tab title bar

Display the header at the top of every tab.

In appearance.json

Only written to appearance.json upon update.

Default:

  "showViewHeader": true

Show ribbon

Display vertical toolbar on the side of the window.

In appearance.json

Only written to appearance.json upon update.

Default:

  "showRibbon": true

Ribbon menu configuration

Configure what commands appear in the ribbon menu.

Clicking “Manage” will cause this popup to appear:

Ribbon menu

Change what items you want to be active in the ribbon. Drag and drop to change the order.

By default, the ribbon items are displayed in the following order:

• Open quick switcher
• Open graph view
• Create a new canvas
• Open today’s daily note
• Insert template
• Open command palette
• Create new base

Font

Interface font

Set base font for all of Obsidian.

In appearance.json

Only written to appearance.json upon update.

Default:

  "interfaceFontFamily": ""

When unspecified, the font family is set to Segoe UI.

Clicking “Manage” will cause this popup to appear:

Interface font

No custom font is applied right now. Add one below.

Available fonts

• Inter
• Agency FB
• Algerian
• Arial
• Arial Black
• Arial Narrow
• Arial Rounded MT
• BIZ UDGothic
• BIZ UDMincho
• BIZ UDPGothic
• BIZ UDPMincho
• Bahnschrift
• Baskerville Old Face
• Bauhaus 93
• Bell MT
• Berlin Sans FB
• Bernard MT
• Blackadder ITC (Blackadder ITC)
• Bodoni 72 Oldstyle
• Bodoni 72 Smallcaps
• Bodoni MT
• Bodoni MT Poster
• Book Antiqua
• Bookman Old Style
• Bookshelf Symbol 7
• Bradley Hand ITC
• Britannic
• Broadway
• Brush Script MT (Brush Script MT)
• Calibri
• Californian FB
• Calisto MT
• Cambria
• Cambria Math
• Candara
• Cascadia Code
• Cascadia Mono
• Castellar
• Centaur
• Century
• Century Gothic
• Century Schoolbook
• Chiller
• Colonna MT
• Comic Sans MS
• Constantia
• Cooper
• Copperplate Gothic
• Corbel
• Courier
• Courier New
• Curlz MT
• Dubai
• Ebrima
• Edwardian Script ITC (Edwardian Script ITC)
• Elephant
• Engravers MT
• Eras ITC
• Felix Titling
• Footlight MT
• Forte
• Franklin Gothic
• Franklin Gothic Medium
• Freestyle Script (Freestyle Script)
• French Script MT (French Script MT)
• Gabriola
• Gadugi
• Garamond
• Georgia
• Gigi (Gigi)
• Gill Sans MT
• Gloucester MT
• Goudy Old Style
• Goudy Stout
• HP Simplified
• HP Simplified Hans
• HP Simplified Jpan
• Haettenschweiler (Haettenschweiler)
• Harlow Solid (Harlow Solid)
• Harrington
• Helvetica
• High Tower Text
• Impact
• Imprint MT Shadow
• Informal Roman (Informal Roman)
• Ink Free
• Inter
• Javanese Text
• Jokerman
• Juice ITC (Juice ITC)
• Kristen ITC
• Kunstler Script (Kunstler Script)
• Leelawadee UI
• Lucida Bright
• Lucida Calligraphy
• Lucida Console
• Lucida Fax
• Lucida Handwriting
• Lucida Sans
• Lucida Sans Typewriter
• Lucida Sans Unicode
• Magneto (Magneto)
• Maiandra GD
• Malgun Gothic
• Marlett (Marlett)
• Matura M7 Script Capitals
• Meiryo
• Meiryo UI
• MS Gothic
• MS Mincho
• MS PGothic
• MS PMincho
• MS Reference Sans Serif
• MS Reference Specialty (MS Reference Specialty)
• MS UI Gothic
• Microsoft Himalaya
• Microsoft JhengHei
• Microsoft JhengHei UI
• Microsoft New Tai Lue
• Microsoft PhagsPa
• Microsoft Sans Serif
• Microsoft Tai Le
• Microsoft YaHei
• Microsoft YaHei UI
• Microsoft Yi Baiti
• MingLiU-ExtB
• MingLiU_HKSCS-ExtB
• MingLiU_MSCS-ExtB
• Mistral (Mistral)
• Modern No. 20
• Mongolian Baiti
• Monotype Corsiva
• MT Extra (MT Extra)
• MV Boli
• Myanmar Text
• Niagara Engraved (Niagara Engraved)
• Niagara Solid (Niagara Solid)
• Nirmala Text
• Nirmala UI
• Noto Sans JP
• Noto Serif JP
• NSimSun
• OCR A
• Old English Text MT (Old English MT)
• Onyx (Onyx)
• Palace Script MT (Palace Script MT)
• Palatino Linotype
• Papyrus
• Parchment (Parchment)
• Perpetua
• Perpetua Titling MT
• Playbill
• PMingLiU-ExtB
• Poor Richard
• Pristina
• Rage
• Ravie
• Rockwell
• Sans Serif Collection
• Script MT
• Segoe Print
• Segoe Script
• Segoe UI
• Segoe UI Emoji
• Segoe UI Historic
• Segoe UI Symbol
• Segoe UI Variable Display
• Segoe UI Variable Small
• Segoe UI Variable Text
• Showcard Gothic
• SimSun
• SimSun-ExtB
• SimSun-ExtG
• Sitka Banner
• Sitka Display
• Sitka Heading
• Sitka Small
• Sitka Subheading
• Sitka Text
• Snap ITC
• Source Code Pro
• Stencil
• Sylfaen
• Symbol (Symbol)
• Tahoma
• Tempus Sans ITC
• Times
• Times New Roman
• Trebuchet MS
• Tw Cen MT
• UD Digi Kyokasho N
• UD Digi Kyokasho NK
• UD Digi Kyokasho NP
• Verdana
• Viner Hand ITC
• Vivaldi (Vivaldi)
• Vladimir Script (Vladimir Script)
• Webdings (Webdings)
• Wide Latin
• Wingdings (Wingdings)
• Wingdings 2
• Wingdings 3
• Yu Gothic
• Yu Gothic UI
• Yu Mincho

Bugs

• Inter is listed twice.
• The scroll wheel stops scrolling after “Lucida Sans”.

Text font

Set font for editing and reading views.

In appearance.json

Only written to appearance.json upon update.

Default:

  "textFontFamily": ""

When unspecified, the font family is set to Segoe UI.

Clicking “Manage” will cause this popup to appear:

Text font

No custom font is applied right now. Add one below.

Available fonts

• Inter
• Agency FB
• Algerian
• Arial
• Arial Black
• Arial Narrow
• Arial Rounded MT
• BIZ UDGothic
• BIZ UDMincho
• BIZ UDPGothic
• BIZ UDPMincho
• Bahnschrift
• Baskerville Old Face
• Bauhaus 93
• Bell MT
• Berlin Sans FB
• Bernard MT
• Blackadder ITC (Blackadder ITC)
• Bodoni 72 Oldstyle
• Bodoni 72 Smallcaps
• Bodoni MT
• Bodoni MT Poster
• Book Antiqua
• Bookman Old Style
• Bookshelf Symbol 7
• Bradley Hand ITC
• Britannic
• Broadway
• Brush Script MT (Brush Script MT)
• Calibri
• Californian FB
• Calisto MT
• Cambria
• Cambria Math
• Candara
• Cascadia Code
• Cascadia Mono
• Castellar
• Centaur
• Century
• Century Gothic
• Century Schoolbook
• Chiller
• Colonna MT
• Comic Sans MS
• Constantia
• Cooper
• Copperplate Gothic
• Corbel
• Courier
• Courier New
• Curlz MT
• Dubai
• Ebrima
• Edwardian Script ITC (Edwardian Script ITC)
• Elephant
• Engravers MT
• Eras ITC
• Felix Titling
• Footlight MT
• Forte
• Franklin Gothic
• Franklin Gothic Medium
• Freestyle Script (Freestyle Script)
• French Script MT (French Script MT)
• Gabriola
• Gadugi
• Garamond
• Georgia
• Gigi (Gigi)
• Gill Sans MT
• Gloucester MT
• Goudy Old Style
• Goudy Stout
• HP Simplified
• HP Simplified Hans
• HP Simplified Jpan
• Haettenschweiler (Haettenschweiler)
• Harlow Solid (Harlow Solid)
• Harrington
• Helvetica
• High Tower Text
• Impact
• Imprint MT Shadow
• Informal Roman (Informal Roman)
• Ink Free
• Inter
• Javanese Text
• Jokerman
• Juice ITC (Juice ITC)
• Kristen ITC
• Kunstler Script (Kunstler Script)
• Leelawadee UI
• Lucida Bright
• Lucida Calligraphy
• Lucida Console
• Lucida Fax
• Lucida Handwriting
• Lucida Sans
• Lucida Sans Typewriter
• Lucida Sans Unicode
• Magneto (Magneto)
• Maiandra GD
• Malgun Gothic
• Marlett (Marlett)
• Matura M7 Script Capitals
• Meiryo
• Meiryo UI
• MS Gothic
• MS Mincho
• MS PGothic
• MS PMincho
• MS Reference Sans Serif
• MS Reference Specialty (MS Reference Specialty)
• MS UI Gothic
• Microsoft Himalaya
• Microsoft JhengHei
• Microsoft JhengHei UI
• Microsoft New Tai Lue
• Microsoft PhagsPa
• Microsoft Sans Serif
• Microsoft Tai Le
• Microsoft YaHei
• Microsoft YaHei UI
• Microsoft Yi Baiti
• MingLiU-ExtB
• MingLiU_HKSCS-ExtB
• MingLiU_MSCS-ExtB
• Mistral (Mistral)
• Modern No. 20
• Mongolian Baiti
• Monotype Corsiva
• MT Extra (MT Extra)
• MV Boli
• Myanmar Text
• Niagara Engraved (Niagara Engraved)
• Niagara Solid (Niagara Solid)
• Nirmala Text
• Nirmala UI
• Noto Sans JP
• Noto Serif JP
• NSimSun
• OCR A
• Old English Text MT (Old English MT)
• Onyx (Onyx)
• Palace Script MT (Palace Script MT)
• Palatino Linotype
• Papyrus
• Parchment (Parchment)
• Perpetua
• Perpetua Titling MT
• Playbill
• PMingLiU-ExtB
• Poor Richard
• Pristina
• Rage
• Ravie
• Rockwell
• Sans Serif Collection
• Script MT
• Segoe Print
• Segoe Script
• Segoe UI
• Segoe UI Emoji
• Segoe UI Historic
• Segoe UI Symbol
• Segoe UI Variable Display
• Segoe UI Variable Small
• Segoe UI Variable Text
• Showcard Gothic
• SimSun
• SimSun-ExtB
• SimSun-ExtG
• Sitka Banner
• Sitka Display
• Sitka Heading
• Sitka Small
• Sitka Subheading
• Sitka Text
• Snap ITC
• Source Code Pro
• Stencil
• Sylfaen
• Symbol (Symbol)
• Tahoma
• Tempus Sans ITC
• Times
• Times New Roman
• Trebuchet MS
• Tw Cen MT
• UD Digi Kyokasho N
• UD Digi Kyokasho NK
• UD Digi Kyokasho NP
• Verdana
• Viner Hand ITC
• Vivaldi (Vivaldi)
• Vladimir Script (Vladimir Script)
• Webdings (Webdings)
• Wide Latin
• Wingdings (Wingdings)
• Wingdings 2
• Wingdings 3
• Yu Gothic
• Yu Gothic UI
• Yu Mincho

Bugs

• Inter is listed twice.
• The scroll wheel stops scrolling after “Lucida Sans”.

Monospace font

Set font for editing and reading views.

In appearance.json

Only written to appearance.json upon update.

Default:

  "monospaceFontFamily": ""

When unspecified, the font family is set to Cascadia Mono.

Clicking “Manage” will cause this popup to appear:

Monospace font

No custom font is applied right now. Add one below.

Available fonts

• Inter
• Agency FB
• Algerian
• Arial
• Arial Black
• Arial Narrow
• Arial Rounded MT
• BIZ UDGothic
• BIZ UDMincho
• BIZ UDPGothic
• BIZ UDPMincho
• Bahnschrift
• Baskerville Old Face
• Bauhaus 93
• Bell MT
• Berlin Sans FB
• Bernard MT
• Blackadder ITC (Blackadder ITC)
• Bodoni 72 Oldstyle
• Bodoni 72 Smallcaps
• Bodoni MT
• Bodoni MT Poster
• Book Antiqua
• Bookman Old Style
• Bookshelf Symbol 7
• Bradley Hand ITC
• Britannic
• Broadway
• Brush Script MT (Brush Script MT)
• Calibri
• Californian FB
• Calisto MT
• Cambria
• Cambria Math
• Candara
• Cascadia Code
• Cascadia Mono
• Castellar
• Centaur
• Century
• Century Gothic
• Century Schoolbook
• Chiller
• Colonna MT
• Comic Sans MS
• Constantia
• Cooper
• Copperplate Gothic
• Corbel
• Courier
• Courier New
• Curlz MT
• Dubai
• Ebrima
• Edwardian Script ITC (Edwardian Script ITC)
• Elephant
• Engravers MT
• Eras ITC
• Felix Titling
• Footlight MT
• Forte
• Franklin Gothic
• Franklin Gothic Medium
• Freestyle Script (Freestyle Script)
• French Script MT (French Script MT)
• Gabriola
• Gadugi
• Garamond
• Georgia
• Gigi (Gigi)
• Gill Sans MT
• Gloucester MT
• Goudy Old Style
• Goudy Stout
• HP Simplified
• HP Simplified Hans
• HP Simplified Jpan
• Haettenschweiler (Haettenschweiler)
• Harlow Solid (Harlow Solid)
• Harrington
• Helvetica
• High Tower Text
• Impact
• Imprint MT Shadow
• Informal Roman (Informal Roman)
• Ink Free
• Inter
• Javanese Text
• Jokerman
• Juice ITC (Juice ITC)
• Kristen ITC
• Kunstler Script (Kunstler Script)
• Leelawadee UI
• Lucida Bright
• Lucida Calligraphy
• Lucida Console
• Lucida Fax
• Lucida Handwriting
• Lucida Sans
• Lucida Sans Typewriter
• Lucida Sans Unicode
• Magneto (Magneto)
• Maiandra GD
• Malgun Gothic
• Marlett (Marlett)
• Matura M7 Script Capitals
• Meiryo
• Meiryo UI
• MS Gothic
• MS Mincho
• MS PGothic
• MS PMincho
• MS Reference Sans Serif
• MS Reference Specialty (MS Reference Specialty)
• MS UI Gothic
• Microsoft Himalaya
• Microsoft JhengHei
• Microsoft JhengHei UI
• Microsoft New Tai Lue
• Microsoft PhagsPa
• Microsoft Sans Serif
• Microsoft Tai Le
• Microsoft YaHei
• Microsoft YaHei UI
• Microsoft Yi Baiti
• MingLiU-ExtB
• MingLiU_HKSCS-ExtB
• MingLiU_MSCS-ExtB
• Mistral (Mistral)
• Modern No. 20
• Mongolian Baiti
• Monotype Corsiva
• MT Extra (MT Extra)
• MV Boli
• Myanmar Text
• Niagara Engraved (Niagara Engraved)
• Niagara Solid (Niagara Solid)
• Nirmala Text
• Nirmala UI
• Noto Sans JP
• Noto Serif JP
• NSimSun
• OCR A
• Old English Text MT (Old English MT)
• Onyx (Onyx)
• Palace Script MT (Palace Script MT)
• Palatino Linotype
• Papyrus
• Parchment (Parchment)
• Perpetua
• Perpetua Titling MT
• Playbill
• PMingLiU-ExtB
• Poor Richard
• Pristina
• Rage
• Ravie
• Rockwell
• Sans Serif Collection
• Script MT
• Segoe Print
• Segoe Script
• Segoe UI
• Segoe UI Emoji
• Segoe UI Historic
• Segoe UI Symbol
• Segoe UI Variable Display
• Segoe UI Variable Small
• Segoe UI Variable Text
• Showcard Gothic
• SimSun
• SimSun-ExtB
• SimSun-ExtG
• Sitka Banner
• Sitka Display
• Sitka Heading
• Sitka Small
• Sitka Subheading
• Sitka Text
• Snap ITC
• Source Code Pro
• Stencil
• Sylfaen
• Symbol (Symbol)
• Tahoma
• Tempus Sans ITC
• Times
• Times New Roman
• Trebuchet MS
• Tw Cen MT
• UD Digi Kyokasho N
• UD Digi Kyokasho NK
• UD Digi Kyokasho NP
• Verdana
• Viner Hand ITC
• Vivaldi (Vivaldi)
• Vladimir Script (Vladimir Script)
• Webdings (Webdings)
• Wide Latin
• Wingdings (Wingdings)
• Wingdings 2
• Wingdings 3
• Yu Gothic
• Yu Gothic UI
• Yu Mincho

Bugs

• Inter is listed twice.
• The scroll wheel stops scrolling after “Lucida Sans”.

Font size

Font size in pixels that affects editing and reading views.

In appearance.json

Only written to appearance.json upon update.

Default:

  "baseFontSize": 16

Changing font size to a number not supported by the slider

The font size slider only supports values between 10 and 30. Setting baseFontSize in appearance.json to a value outside this range will have no effect.

Quick font size adjustment

Adjust the font size using Ctrl + Scroll or using the trackpad pinch-zoom gesture.

In appearance.json

Only written to appearance.json upon update.

Default:

  "baseFontSizeAction": false

Advanced

Zoom level

Controls the overall zoom level of the app.

Default: 100% (slider allows a range between 63% and 173%)

Native menus

Menus throughout the app will match the operating system. They will not be affected by your theme.

In appearance.json

Only written to appearance.json upon update.

Default:

  "nativeMenus": false

Window frame style

Determines the styling of the title bar of Obsidian windows. Requires a full restart to take effect.

• Hidden (default)
• Obsidian frame
• Native frame

Custom app icon

Set a custom icon for the app

Custom app icon in the Windows taskbar

Accepted file formats are .icns, .ico, .png, and .svg.

For certain Windows operating systems, an extra step may be needed to adjust the custom app icon in the taskbar.

Follow these steps:

• Right-click the Obsidian icon on your taskbar or desktop shortcut.
• Right-click the name Obsidian (skip this step for the desktop icon).
• Choose Properties.
• Click Change Icon.
• Locate the icon on your file system.
• Click OK.

Afterward, you have the option to either restart explorer.exe within the task manager or restart your computer to apply the changes you made.

Bug

Missing period in documentation.

Hardware acceleration

Turns on Hardware Acceleration, which uses your GPU to make Obsidian smoother. If you turn this off, app performance will be severely degraded.

CSS snippets

CSS snippets are stored in “vault/.obsidian/snippets”. Learn more

Info

If there is no snippets folder in .obsidian, clicking the folder icon will create it.

Hotkeys

Command	Hotkey
Add alias	Blank
Add cursor above	Blank
Add cursor below	Blank
Add embed	Blank
Add file property	Ctrl + ;
Add internal link	Blank
Add tag	Blank
Audio recorder: Start recording	Blank
Audio recorder: Stop recording	Blank
Backlinks: Open backlinks for the current note	Blank
Backlinks: Show backlinks	Blank
Backlinks: Toggle backlinks in document	Blank
Bases: Add item	Blank
Bases: Add view	Blank
Bases: Copy table to clipboard	Blank
Bases: Create new base	Blank
Bases: Insert new base	Blank
Bases: Switch view…	Blank
Bookmarks: Bookmark all tabs…	Blank
Bookmarks: Bookmark block under cursor…	Blank
Bookmarks: Bookmark current search…	Blank
Bookmarks: Bookmark heading under cursor…	Blank
Bookmarks: Bookmark…	Blank
Bookmarks: Remove bookmark for the current file	Blank
Bookmarks: Show bookmarks	Blank
Canvas: Convert to file…	Blank
Canvas: Create new canvas	Blank
Canvas: Export as image	Blank
Canvas: Jump to group	Blank
Change theme…	Blank
Change vault…	Blank
Clear file properties	Blank
Clear formatting	Blank
Close all other tabs	Blank
Close current tab	Ctrl + W
Close others in tab group	Blank
Close this tab group	Blank
Close window	Ctrl + Shift + W
Command palette: Open command palette	Ctrl + P
Copy current file path from system root	Blank
Copy current file path from vault folder	Blank
Copy Obsidian URL for current file	Blank
Create new note	Ctrl + N
Create new note in current tab	Blank
Create note to the right	Ctrl + Shift + N
Cycle bullet / checkbox	Blank
Daily note: Open next daily note	Blank
Daily note: Open previous daily note	Blank
Daily note: Open today’s daily note	Blank
Delete current file	Blank
Delete paragraph	Ctrl + D
Download attachments for current file	Blank
Export to PDF…	Blank
File recovery: Open local history	Blank
Files: Create new folder	Blank
Files: Reveal current file in navigation	Blank
Files: Show file explorer	Blank
Focus on last note	Blank
Focus on tab group above	Blank
Focus on tab group below	Blank
Focus on tab group to the left	Blank
Focus on tab group to the right	Blank
Fold all headings and listings	Blank
Fold less	Blank
Fold more	Blank
Follow link under cursor	Alt + Enter
Footnotes view: Show footnotes	Blank
Format converter: Open format converter	Blank
Go to last tab	Ctrl + 9
Go to next tab	Ctrl + Tab Ctrl + Page Down
Go to previous tab	Ctrl + Shift + Tab Ctrl + Page Up
Go to tab #1	Ctrl + 1
Go to tab #2	Ctrl + 2
Go to tab #3	Ctrl + 3
Go to tab #4	Ctrl + 4
Go to tab #5	Ctrl + 5
Go to tab #6	Ctrl + 6
Go to tab #7	Ctrl + 7
Go to tab #8	Ctrl + 8
Graph view: Open graph view	Ctrl + G
Graph view: Open local graph	Blank
Graph view: Start graph timelapse animation	Blank
Indent list item	Blank
Insert attachment	Blank
Insert callout	Blank
Insert code block	Blank
Insert footnote	Blank
Insert horizontal rule	Blank
Insert Markdown link	Ctrl + K
Insert Math bloc	Blank
Insert table	Blank
Make a copy of the current file	Blank
Manage vaults	Blank
Move current file to another folder	Blank
Move current tab to new window	Blank
Move line down	Blank
Move line up	Blank
Navigate back	Ctrl + Alt + ⇦
Navigate forward	Ctrl + Alt + ⇨
New tab	Ctrl + T
New window	Blank
Note composer: Extract current selection	Blank
Note composer: Extract this heading…	Blank
Note composer: Merge file with another file	Blank
Open current tab in new window	Blank
Open help	F1
Open in default app	Blank
Open link under cursor in new tab	Ctrl + Enter
Open link under cursor in new window	Ctrl + Alt + Shift + Enter
Open link under cursor to the right	Ctrl + Alt + Enter
Open sandbox vault	Blank
Open settings	Ctrl + ,
Open vault…	Blank
Outgoing links: Open outgoing links for the current file	Blank
Outgoing links: Show outgoing links	Blank
Outline: Open outline of the current file	Blank
Outline: Show outline	Blank
Properties view: Show all properties	Blank
Properties view: Show file properties	Blank
Publish: Open in live site	Blank
Publish: Publish changes	Blank
Publish: Publish current file	Blank
Quick switcher: Open quick switcher	Ctrl + 0
Reload app without saving	Blank
Remove heading	Blank
Rename file	F2
Rename this heading…	Blank
Reset zoom	Blank
Save current file	Ctrl + S
Search and replace in current file	Ctrl + H
Search current file	Ctrl + F
Search: Search in all files	Ctrl + Shift + F
Set as heading 1	Blank
Set as heading 2	Blank
Set as heading 3	Blank
Set as heading 4	Blank
Set as heading 5	Blank
Set as heading 6	Blank
Show context menu under cursor	Blank
Show debug info	Blank
Show in system explorer	Blank
Show release notes	Blank
Show trash	Blank
Slides: Start presentation	Blank
Split down	Blank
Split right	Blank
Sync: Show activity log	Blank
Sync: Open version history for current file	Blank
Sync: Set up Sync	Blank
Sync: Show Sync history	Blank
Table: Add column to the left	Blank
Table: Add column to the right	Blank
Table: Add row above	Blank
Table: Add row below	Blank
Table: Align center (text)	Blank
Table: Align left (text)	Blank
Table: Delete column	Blank
Table: Delete row	Blank
Table: Duplicate column	Blank
Table: Duplicate row	Blank
Table: Move column left	Blank
Table: Move column right	Blank
Table: Move row down	Blank
Table: Move row up	Blank
Tags view: Show tags	Blank
Templates: Insert current date	Blank
Templates: Insert current time	Blank
Templates: Insert template	Blank
Toggle blockquote	Blank
Toggle bold	Ctrl + B
Toggle bullet list	Blank
Toggle checkbox status	Ctrl + L
Toggle code	Blank
Toggle comment	Ctrl + /
Toggle default mode for new tabs	Blank
Toggle fold on current line	Blank
Toggle fold properties in current file	Blank
Toggle heading	Blank
Toggle highlight	Blank
Toggle inline math	Blank
Toggle italic	Ctrl + I
Toggle left sidebar	Blank
Toggle light/dark mode	Blank
Toggle line numbers	Blank
Toggle Live Preview/Source Mode	Blank
Toggle numbered list	Blank
Toggle pin	Blank
Toggle readable line length	Blank
Toggle reading view	Ctrl + E
Toggle ribbon	Blank
Toggle right sidebar	Blank
Toggle spellcheck	Blank
Toggle stacked tabs	Blank
Toggle strikethrough	Blank
Toggle window always on top	Blank
Undo closed tab	Ctrl + Shift + T
Unfold all headings and lists	Blank
Unindent list item	Blank
Web viewer: Focus address bar	Blank
Web viewer: Open web viewer	Blank
Web viewer: Reset zoom	Blank
Web viewer: Save to vault	Blank
Web viewer: Search the web	Blank
Web viewer: Show history	Blank
Web viewer: Toggle reader mode	Blank
Web viewer: Zoom in	Blank
Web viewer: Zoom out	Blank
Workspaces: Load workspace layout	Blank
Workspaces: Manage workspace layouts	Blank
Workspaces: Save and load another layout	Blank
Workspaces: Save layout	Blank
Zoom in	Blank
Zoom out	Blank

Keychain

Secrets

Secrets are used to store information like API keys and passwords.

When clicking the plus sign to add a secret, you will receive this popup:

Add secret

ID Lowercase letters, numbers, and dashes only.

Secret Enter your secret

Core plugins

Audio recorder

Record audio notes and save them as attachments.

In core-plugins.json

Default:

  "audio-recorder": false

My settings

I turned this on.

Related hotkeys:

• Audio recorder: Start recording audio
• Audio recorder: Stop recording audio

Backlinks

Show links from other files to the current file. Backlinks can be shown in a separate view or at the bottom of the note.

In core-plugins.json

Default:

  "backlink": true

Show backlinks at the bottom of notes

Make backlinks visible in new tabs by default.

In backlink.json

Only written to backlink.json upon update. If there isn’t a backlink.json, it will be created.

Default:

  "backlinkInDocument": false

Related hotkeys:

• Backlinks: Open backlink for current note
• Backlinks: Show backlinks
• Backlinks: Toggle backlinks in document

Bases

Create custom views that let you edit, sort, and filter files using their properties.

In core-plugins.json

Default:

  "bases": true

Related hotkeys:

• Bases: Add item
• Bases: Add view
• Bases: Copy table to clipboard
• Bases: Create new base
• Bases: Insert new base
• Bases: Switch view…

Bookmarks

Save shortcuts to files, searches, headings, and graphs.

In core-plugins.json

Default:

  "bookmarks": true

Related hotkeys:

• Bookmarks: Bookmark all tabs…
• Bookmarks: Bookmark block under cursor…
• Bookmarks: Bookmark current search…
• Bookmarks: Bookmark heading under cursor…
• Bookmarks: Bookmark…
• Bookmarks: Remove bookmark for the current file
• Bookmarks: Show bookmarks

Canvas

Arrange and connect notes on an infinite canvas.

In core-plugins.json

Default:

  "canvas": true

Default location for new canvas files

• Vault folder (“root”)
• Same folder as current file (“current”)
• In the folder specified below (“folder”)

In canvas.json

Only written to canvas.json upon update. If there isn’t a canvas.json, it will be created.

Default:

  "newFileLocation": "root"

My settings

I selected “Same folder as current file”.

Folder to create new canvas file in

Newly created canvas files will appear under this folder. This setting only appears “In the folder specified below” is selected.

In canvas.json

Only written to canvas.json upon update. If there isn’t a canvas.json, it will be created.

Default:

  "newFileFolderPath": ""

The JSON property is retained even after switching the file location to a different dropdown option. However, the JSON property only takes effect when the location is set to “In the folder specified below”.

Default mouse behavior

• Pan (“pan”)
• Zoom (“zoom”)

In canvas.json

Only written to canvas.json upon update. If there isn’t a canvas.json, it will be created.

Default:

  "defaultWheelBehavior": "root"

Default Ctrl + Drag behavior

• Show menu (“menu”)
• Add card (“card”)
• Add note from vault (“note”)
• Add media from vault (“media”)
• Add webpage (“webpage”)
• Create group (“group”)

In canvas.json

Only written to canvas.json upon update. If there isn’t a canvas.json, it will be created.

Default:

  "defaultModDragBehavior": "menu"

Show card names

• Always (“always”)
• On hover (“hover”)
• Never (“never”)

In canvas.json

Only written to canvas.json upon update. If there isn’t a canvas.json, it will be created.

Default:

  "cardLabelVisibility": "always"

Snap to grid

Snap cards to the background grid when moving and resizing.

In canvas.json

If there isn’t a canvas.json, it will be created.

Default:

  "snapToGrid": "true"

Snap to objects

Snap cards to nearby objects when moving and resizing.

In canvas.json

If there isn’t a canvas.json, it will be created.

Default:

  "snapToObjects": "true"

Zoom threshold for hiding card content

Lower values will increase performance but hide card content sooner when zooming out.

In canvas.json

Only written to canvas.json upon update. If there isn’t a canvas.json, it will be created.

The slider value ranges from -0.7 to 2.39.

Default:

  "zoomBreakpoint": 0

Editing the value to a number not within the slider range will not have any effect.

Related hotkeys:

• Canvas: Convert to file…
• Canvas: Create new canvas
• Canvas: Export as image
• Canvas: Jump to group

Command Palette

Use Cmd/Ctrl + P and begin typing to invoke a command.

In core-plugins.json

Default:

  "command-palette": true

Pinned commands

You can pin certain commands to always appear at the top of the command suggestions when using the Command Palette.

Related hotkeys:

• Command palette: Open command palette

Daily notes

Create or open today’s daily note.

In core-plugins.json

Default:

  "daily-notes": true

Date format (Daily notes)

Choose how daily notes are named in your vault.

• 2026-12-31 (“YYYY-MM-DD”)
• 2026.12.31 (“YYYY.MM.DD”)
• 2026/12/31 (“YYYY/MM/DD”)
• 2026/12/2026-12-31 (“YYYY/MM/YYYY-MM-DD”)
• Custom

In daily-notes.json

Only written to daily-notes.json upon update. If there isn’t a daily-notes.json, it will be created. Default:

  "format": "YYYY-MM-DD"

Custom format

For more syntax, refer to format reference.

NOTE

Whatever is placed in the field will be applied to the format JSON property in daily-notes.json,

My settings

I used YYYY/MMMM/YYYY-MM-DD

Related hotkeys:

• Daily note: Open next daily note
• Daily note: Open previous daily note
• Daily note: Open today’s daily note

File recovery

Restore recent snapshots to recover from accidental data loss. Snapshots are only saved for Markdown files.

In core-plugins.json

Default:

  "file-recovery": true

Snapshot interval

Minimal interval in minutes between two snapshots.

In file-recovery.json

If there isn’t a file-recovery.json, it will be created. Default:

  "intervalMinutes": 5

History length

Number of days the snapshots are kept for.

In file-recovery.json

If there isn’t a file-recovery.json, it will be created. Default:

  "keepDays": 7

Snapshots

View and restore saved snapshots.

Clear history

Delete all snapshots.

Upon clicking “Clear”, you will receive this popup:

Clear history

Are you sure you want to delete your snapshots? Files in your vault will not be affected.

[ Clear ] [ Cancel ]

Related hotkeys:

• File recovery: Open local history

Files

Browse the files and folders in your vault.

In core-plugins.json

Default:

  "file-explorer": true

Related hotkeys:

• Create new note
• Create new note in current tab
• Create note to the right
• Files: Create new folder
• Files: Reveal current file in navigation
• Files: Show file explorer
• Make a copy of the current file
• Move current file to another folder

Footnotes view

Show a list of footnotes from the current note.

In core-plugins.json

Default:

  "footnotes": false

Related hotkeys:

• Footnotes view: Show footnotes

Format converter

Convert Markdown from other apps to Obsidian format.

In core-plugins.json

Default:

  "markdown-importer": false

Related hotkeys:

• Format converter: Open format converter

Graph view

Visualize the relationships between your notes.

In core-plugins.json

Default:

  "graph": true

Related hotkeys:

• Graph view: Open graph view
• Graph view: Open local graph
• Graph view: Start graph timelapse animation

Note composer

Merge two notes or split one into two.

In core-plugins.json

Default:

  "note-composer": true

Text after extraction

What to show in place of the selected text after extracting it.

• Link to new file (“link”)
• Embed to new file (“embed”)
• None (“none”)

In note-composer.json

If there isn’t a note-composer.json, it will be created. Default:

  "replacementText": "link"

Template file location (Note composer)

Template file to use when merging or extracting. Available variables: {{content}}, {{fromTitle}}, {{newTitle}}, {{date:FORMAT}}, e.g. {{date:YYYY-MM-DD}}.

In note-composer.json

If there isn’t a note-composer.json, it will be created. Default:

  "template": ""

Confirm file merge

Prompt before merge two files.

In note-composer.json

If there isn’t a note-composer.json, it will be created. Default:

  "askBeforeMerging": true

Related hotkeys:

• Note composer: Extract current selection
• Note composer: Extract this heading…
• Note composer: Merge file with another file

Outgoing links

Show outgoing links and detect unlinked mentions of other notes in the current note.

In core-plugins.json

Default:

  "outgoing-link": true

Outline

Show the table of contents for the current note.

In core-plugins.json

Default:

  "outline": true

Related hotkeys:

• Outline: Open outline of the current file
• Outline: Show outline

Page Preview

Hover an internal link to preview its contents. In editor mode, press Ctrl/Cmd while hovering.

In core-plugins.json

Default:

  "page-preview": true

Require Ctrl to trigger page preview on hover

Search, Backlinks, and Outgoing links

In page-preview.json

Only written to page-preview.json upon update. If there isn’t a page-preview.json, it will be created. Default:

  "search": true

Reading view

In page-preview.json

Only written to page-preview.json upon update. If there isn’t a page-preview.json, it will be created. Default:

  "preview": false

Editing view

In page-preview.json

Only written to page-preview.json upon update. If there isn’t a page-preview.json, it will be created. Default:

  "editor": true

Tab header

In page-preview.json

Only written to page-preview.json upon update. If there isn’t a page-preview.json, it will be created. Default:

  "tab-header": true

Files

In page-preview.json

Only written to page-preview.json upon update. If there isn’t a page-preview.json, it will be created. Default:

  "file-explorer": true

Properties view

In page-preview.json

Only written to page-preview.json upon update. If there isn’t a page-preview.json, it will be created. Default:

  "properties": true

Bookmarks

In page-preview.json

Only written to page-preview.json upon update. If there isn’t a page-preview.json, it will be created. Default:

  "bookmarks": true

Outline

In page-preview.json

Only written to page-preview.json upon update. If there isn’t a page-preview.json, it will be created. Default:

  "outline": true

Bases

In page-preview.json

Only written to page-preview.json upon update. If there isn’t a page-preview.json, it will be created. Default:

  "bases": true

Graph view

In page-preview.json

Only written to page-preview.json upon update. If there isn’t a page-preview.json, it will be created. Default:

  "graph": true

Properties view

Show the metadata for your files in the sidebar.

In core-plugins.json

Default:

  "properties": true

Related hotkeys:

• Properties view: Show all properties
• Properties view: Show file properties

Publish

Host your notes online as a website, wiki or documentation.

In core-plugins.json

Default:

  "publish": false

Bug

No Oxford comma.

Related hotkeys:

• Publish: Open in live site
• Publish: Publish changes
• Publish: Publish current file

Quick switcher

Jump to other files with your keyboard.

In core-plugins.json

Default:

  "switcher": true

Show existing only

Only show results from existing files. Links to files that are not yet created will be hidden.

In switcher.json

Only written to switcher.json upon update. If there isn’t a switcher.json, it will be created. Default:

  "showExistingOnly": false

My settings

I set it to true.

Show attachments

Show attachment files like images, videos, and PDFs.

In switcher.json

Only written to switcher.json upon update. If there isn’t a switcher.json, it will be created. Default:

  "showAttachments": true

Show all file types (Quick switcher)

Show all file including ones that Obsidian can’t open. The file will be opened with the default app for that file type.

In switcher.json

Only written to switcher.json upon update. If there isn’t a switcher.json, it will be created. Default:

  "showAllFileTypes": false

My settings

I set it to true.

Related hotkeys:

• Quick switcher: Open quick switcher

Random note

Open a random note to rediscover or review.

In core-plugins.json

Default:

  "random-note": false

Search

Search for a keyword in all notes.

In core-plugins.json

Default:

  "global-search": true

Related hotkeys:

• Search: Search in all files

Slash commands

Trigger commands in the editor by using the forward slash key.

In core-plugins.json

Default:

  "slash-command": false

Slides

Create a presentation by using ”---” to separate slides.

In core-plugins.json

Default:

  "slides": false

Related hotkeys:

• Slides: Start presentation

Sync

Synchronize your files through Obsidian Sync.

In core-plugins.json

Obsidian Sync is Obsidian’s add-on sync service with end-to-end encryption and version history.

To start syncing, please log in or create a new Obsidian account.

Default:

  "sync": true

My settings

I set this to false.

Related hotkeys:

• Sync: Show activity log
• Sync: Open version history for current file
• Sync: Set up Sync
• Sync: Show Sync history

Tags view

Show a list of all tags and their number of occurrences.

In core-plugins.json

Default:

  "tag-pane": true

Related hotkeys:

• Tags view: Show tags

Templates

Insert template content from a folder of template files.

In core-plugins.json

Default:

  "templates": true

Template folder location

Files in this folder will be available as templates.

In templates.json`

Only written to templates.json upon update. If there isn’t a templates.json, it will be created. Default:

  "folder": ""

Date format (Templates)

{{date}} in the template file will be replaced by this value. You can also use {{date:YYYY-MM-DD}} to override the format once. For more syntax, refer to format reference

In templates.json`

Only written to templates.json upon update. If there isn’t a templates.json, it will be created. Default:

  "dateformat": ""

Bug

Missing period.

Time format

{{time}} in the template file will be replaced by this value. You can also use {{time:HH:mm}} to override the format once. For more syntax, refer to format reference

In templates.json`

Only written to templates.json upon update. If there isn’t a templates.json, it will be created. Default:

  "timeformat": ""

Bug

Missing period.

Unique note creator

Create notes with unique timestamp prefixes, for workflows like zettelkasten or slip box.

In core-plugins.json

Default:

  "zk-prefixer": false

New file location

The folder path to create the new unique note in.

In zk-prefixer.json

Only written to zk-prefixer.json upon update. If there isn’t a zk-prefixer.json, it will be created. Default:

  "folder": ""

Template file location (Unique note creator)

The file path to use as template.

In zk-prefixer.json

Only written to zk-prefixer.json upon update. If there isn’t a zk-prefixer.json, it will be created.

Default:

  "template": ""

Unique prefix format

For more syntax, refer to format reference

In zk-prefixer.json

Only written to zk-prefixer.json upon update. If there isn’t a zk-prefixer.json, it will be created.

Default:

  "format": ""

Bug

Missing period.

Web viewer

Open external links to web pages inside Obsidian.

In core-plugins.json

Default:

  "webviewer": false

Open external links

Open links in Obsidian rather than the system default.

In webviewer.json

Only written to webviewer.json upon update. If there isn’t a webviewer.json, it will be created.

Default:

  "openExternalURLs": true

Homepage

What page to view when a web viewer is opened

In webviewer.json

Only written to webviewer.json upon update. If there isn’t a webviewer.json, it will be created.

Default:

  "homepage": ""

Bug

Missing period.

Saved page folder

Websites saved as markdown will be placed here.

In webviewer.json

Only written to webviewer.json upon update. If there isn’t a webviewer.json, it will be created.

Default:

  "markdownPath": ""

Search engine

Search engine used when searching from the address bar.

• DuckDuckGo (“duckduckgo”)
• Brave (“brave”)
• Bing (“bing”)
• Google (“google”)
• Custom (“custom”)

In webviewer.json

Only written to webviewer.json upon update. If there isn’t a webviewer.json, it will be created.

Default:

  "searchEngine": "duckduckgo"

My settings

I set it to "bing".

Custom search engine

Search engine used when searching from the address bar.

In webviewer.json

Only written to webviewer.json upon update. If there isn’t a webviewer.json, it will be created.

Default:

  "customSearchEngine": "https://duckduckgo.com/?q=%s"

The JSON property is retained even after switching the search engine to a different dropdown option. However, the JSON property only takes effect when the search engine is set to “Custom”.

Enable ad blocker

If enabled, the filter lists below will be applied to all web viewer tabs.

In webviewer.json

If there isn’t a webviewer.json, it will be created.

Default:

  "enableAdblocking": true

Ad blocking rules

One ad block list URL per line. Shared by all vaults.

Default:

• https://easylist.to/easylist/easylist.txt
• https://easylist.to/easylist/easyprivacy.txt

Ad block update frequency

Days between updating filter lists. 0 indicates disabled. Shared by all vaults.

Default: ??? (slider ranges from 0 to 24)

Web view data

When clicking “Clear web viewer data”, you will receive this popup:

Clear web viewer data

Cookies May sign you out of websites.

Cached data

History

All web viewer data Removes all the above as well as local storage and active sessions.

Related hotkeys:

• Web viewer: Focus address bar
• Web viewer: Open web viewer
• Web viewer: Reset zoom
• Web viewer: Save to vault
• Web viewer: Search the web
• Web viewer: Show history
• Web viewer: Toggle reader mode
• Web viewer: Zoom in
• Web viewer: Zoom out

Word count

Show word count in the status bar.

In core-plugins.json

Default:

  "word-count": true

Workspaces

Save and load workspace layouts.

In core-plugins.json

Default:

  "workspaces": false

My settings

I set it to true.

Related hotkeys:

• Workspaces: Load workspace layout
• Workspaces: Manage workspace layouts
• Workspaces: Save and load another layout
• Workspaces: Save layout

Community Plugins

Restricted mode

Turn on to disable community plugins.

Community plugins

Browse and install community plugins made by our amazing community.

Automatically check for updates

Periodically check for plugin updates

Default: false

My settings

I set it to true.