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.
useNoteTitleForLink
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
- type: currently only
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.