Link Search Menu Expand Document

Config

Dendron configuration currently lives in two places:

  • Dendron config: dendron.yml located at the root of your workspace
  • VSCode config: dendron.code-workspace: the vscode workspace file

Dendron Config

lookupConfirmVaultOnCreate

With this set, you can pick the vault for new notes.

mermaid (optional)

  • default: false

Turn on to enable mermaid support

useFMTitle

When set to true, use frontmatter as title when publishing and in the preview.

If true, use the note title when displaying naked links

  • NOTE: this is not yet fully supported for multi-vault. specifically, cross vault links are not yet supported

vaults

Tracks vaults for the workspace. You shouldn't have to manually edit this value. This is updated automatically when you first initialize a workspace and when you add or remove vaults to your workspace.

Vault properties:

fsPath
  • file path to vault
name
  • default: last component of fsPath

vault name

remote?
  • added property for remote vaults
  • properties
    • type: currently only git is supported (in the future, we might add additional types)
    • url: url to github repo

Local Vault Example

vaults:
    - fsPath: vault

Remote Vault Example

vaults:
    -
        fsPath: repos/dendron-vault
        remote:
            type: git
            url: 'git@github.com:kevinslin/dendron-vault.git'
        name: dendron
    -
        fsPath: repos/yc-vault
        remote:
            type: git
            url: 'git@github.com:kevinslin/yc-vault.git'
        name: yc

VSCode Config

dendron.dailyJournalDomain

  • type: string
  • default: daily

domain where daily journals are kept

dendron.defaultJournalName

  • type: string
  • default: journal

name used for journal notes

dendron.defaultJournalDateFormat

  • type: string
  • default: y.MM.dd

Date format used for journal notes. Use luxon style formatting

dendron.defaultJournalAddBehavior

  • type: string
  • default: childOfDomain
  • options: ['childOfDomain', 'childOfDomainNamespace', 'childOfCurrent', 'asOwnDomain']

strategy for adding new journal notes

dendron.defaultScratchName

  • type: string
  • default: scratch

Name used for scratch notes. Date format used for scratch notes. Use luxon style formatting

dendron.defaultScratchDateFormat

  • type: string
  • default: y.MM.dd.HHmmss

date format used for scratch notes

dendron.defaultScratchAddBehavior

  • type: string
  • default: asOwnDomain
  • options: ['childOfDomain', 'childOfDomainNamespace', 'childOfCurrent', 'asOwnDomain']

strategy for adding new scratch notes

dendron.copyNoteUrlRoot

  • type: string
  • default: none

override root url when getting note url

dendron.linkSelectAutoTitleBehavior

  • type: string
  • default: slug
  • options: ['none', 'slug']

Control title behavior when using selection2link with lookup

dendron.defaultLookupCreateBehavior

  • type: string
  • default: selectionExtract
  • options: ['selection2link', 'selectionExtract']

when creating a new note with selected text, define behavior for selected text

dendron.rootDir

  • type: string
  • default:

location of dendron workspace

dendron.dendronDir

  • type: string
  • default:

location of dendron configuration

dendron.logLevel

  • type: string
  • default: info
  • options: ['debug', 'info', 'error']

control verbosity of dendron logs

dendron.trace.server

  • type: string
  • default: messages
  • options: ['off', 'messages', 'verbose']

LSP log level

dendron.serverPort

  • type: number
  • default: none

port for server. If not set, will be randomly generated at startup.