320 lines
13 KiB
Lua
320 lines
13 KiB
Lua
return {
|
|
'epwalsh/obsidian.nvim',
|
|
version = '*', -- recommended, use latest release instead of latest commit
|
|
lazy = true,
|
|
ft = 'markdown',
|
|
-- Replace the above line with this if you only want to load obsidian.nvim for markdown files in your vault:
|
|
-- event = {
|
|
-- -- If you want to use the home shortcut '~' here you need to call 'vim.fn.expand'.
|
|
-- -- E.g. "BufReadPre " .. vim.fn.expand "~" .. "/my-vault/*.md"
|
|
-- -- refer to `:h file-pattern` for more examples
|
|
-- "BufReadPre path/to/my-vault/*.md",
|
|
-- "BufNewFile path/to/my-vault/*.md",
|
|
-- },
|
|
dependencies = {
|
|
-- Required.
|
|
'nvim-lua/plenary.nvim',
|
|
|
|
-- see below for full list of optional dependencies 👇
|
|
},
|
|
opts = {
|
|
workspaces = {
|
|
{
|
|
name = 'personal',
|
|
path = 'E:/Stories',
|
|
},
|
|
},
|
|
-- A list of workspace names, paths, and configuration overrides.
|
|
-- If you use the Obsidian app, the 'path' of a workspace should generally be
|
|
-- your vault root (where the `.obsidian` folder is located).
|
|
-- When obsidian.nvim is loaded by your plugin manager, it will automatically set
|
|
-- the workspace to the first workspace in the list whose `path` is a parent of the
|
|
-- current markdown file being edited.
|
|
|
|
-- Alternatively - and for backwards compatibility - you can set 'dir' to a single path instead of
|
|
-- 'workspaces'. For example:
|
|
-- dir = "~/vaults/work",
|
|
|
|
-- Optional, if you keep notes in a specific subdirectory of your vault.
|
|
notes_subdir = 'notes',
|
|
|
|
-- Optional, set the log level for obsidian.nvim. This is an integer corresponding to one of the log
|
|
-- levels defined by "vim.log.levels.*".
|
|
log_level = vim.log.levels.INFO,
|
|
|
|
daily_notes = {
|
|
-- Optional, if you keep daily notes in a separate directory.
|
|
folder = 'notes/dailies',
|
|
-- Optional, if you want to change the date format for the ID of daily notes.
|
|
date_format = '%Y-%m-%d',
|
|
-- Optional, if you want to change the date format of the default alias of daily notes.
|
|
alias_format = '%B %-d, %Y',
|
|
-- Optional, default tags to add to each new daily note created.
|
|
default_tags = { 'daily-notes' },
|
|
-- Optional, if you want to automatically insert a template from your template directory like 'daily.md'
|
|
template = nil,
|
|
},
|
|
|
|
-- Optional, completion of wiki links, local markdown links, and tags using nvim-cmp.
|
|
completion = {
|
|
-- Set to false to disable completion.
|
|
nvim_cmp = true,
|
|
-- Trigger completion at 2 chars.
|
|
min_chars = 2,
|
|
},
|
|
|
|
-- Optional, configure key mappings. These are the defaults. If you don't want to set any keymappings this
|
|
-- way then set 'mappings = {}'.
|
|
|
|
-- Where to put new notes. Valid options are
|
|
-- * "current_dir" - put new notes in same directory as the current buffer.
|
|
-- * "notes_subdir" - put new notes in the default notes subdirectory.
|
|
new_notes_location = 'current_dir',
|
|
|
|
-- Optional, customize how note IDs are generated given an optional title.
|
|
---@param title string|?
|
|
---@return string
|
|
note_id_func = function(title)
|
|
-- Create note IDs in a Zettelkasten format with a timestamp and a suffix.
|
|
-- In this case a note with the title 'My new note' will be given an ID that looks
|
|
-- like '1657296016-my-new-note', and therefore the file name '1657296016-my-new-note.md'
|
|
local suffix = ''
|
|
if title ~= nil then
|
|
-- If title is given, transform it into valid file name.
|
|
suffix = title:gsub(' ', '-'):gsub('[^A-Za-z0-9-]', ''):lower()
|
|
else
|
|
-- If title is nil, just add 4 random uppercase letters to the suffix.
|
|
for _ = 1, 4 do
|
|
suffix = suffix .. string.char(math.random(65, 90))
|
|
end
|
|
end
|
|
return tostring(os.time()) .. '-' .. suffix
|
|
end,
|
|
|
|
-- Optional, customize how note file names are generated given the ID, target directory, and title.
|
|
---@param spec { id: string, dir: obsidian.Path, title: string|? }
|
|
---@return string|obsidian.Path The full path to the new note.
|
|
note_path_func = function(spec)
|
|
-- This is equivalent to the default behavior.
|
|
local path = spec.dir / tostring(spec.id)
|
|
return path:with_suffix '.md'
|
|
end,
|
|
|
|
-- Optional, customize how wiki links are formatted. You can set this to one of:
|
|
-- * "use_alias_only", e.g. '[[Foo Bar]]'
|
|
-- * "prepend_note_id", e.g. '[[foo-bar|Foo Bar]]'
|
|
-- * "prepend_note_path", e.g. '[[foo-bar.md|Foo Bar]]'
|
|
-- * "use_path_only", e.g. '[[foo-bar.md]]'
|
|
-- Or you can set it to a function that takes a table of options and returns a string, like this:
|
|
wiki_link_func = function(opts)
|
|
return require('obsidian.util').wiki_link_id_prefix(opts)
|
|
end,
|
|
|
|
-- Optional, customize how markdown links are formatted.
|
|
markdown_link_func = function(opts)
|
|
return require('obsidian.util').markdown_link(opts)
|
|
end,
|
|
|
|
-- Either 'wiki' or 'markdown'.
|
|
preferred_link_style = 'wiki',
|
|
|
|
-- Optional, boolean or a function that takes a filename and returns a boolean.
|
|
-- `true` indicates that you don't want obsidian.nvim to manage frontmatter.
|
|
disable_frontmatter = false,
|
|
|
|
-- Optional, alternatively you can customize the frontmatter data.
|
|
---@return table
|
|
note_frontmatter_func = function(note)
|
|
-- Add the title of the note as an alias.
|
|
if note.title then
|
|
note:add_alias(note.title)
|
|
end
|
|
|
|
local out = { id = note.id, aliases = note.aliases, tags = note.tags }
|
|
|
|
-- `note.metadata` contains any manually added fields in the frontmatter.
|
|
-- So here we just make sure those fields are kept in the frontmatter.
|
|
if note.metadata ~= nil and not vim.tbl_isempty(note.metadata) then
|
|
for k, v in pairs(note.metadata) do
|
|
out[k] = v
|
|
end
|
|
end
|
|
|
|
return out
|
|
end,
|
|
|
|
-- Optional, for templates (see below).
|
|
templates = {
|
|
folder = 'templates',
|
|
date_format = '%Y-%m-%d',
|
|
time_format = '%H:%M',
|
|
-- A map for custom variables, the key should be the variable and the value a function
|
|
substitutions = {},
|
|
},
|
|
|
|
-- Optional, by default when you use `:ObsidianFollowLink` on a link to an external
|
|
-- URL it will be ignored but you can customize this behavior here.
|
|
---@param url string
|
|
follow_url_func = function(url)
|
|
-- Open the URL in the default web browser.
|
|
|
|
if vim.g.os == 'Windows' then
|
|
vim.cmd(':silent exec "!start ' .. url .. '"') -- Windows
|
|
else
|
|
vim.fn.jobstart { 'open', url } -- Mac OS
|
|
end
|
|
-- vim.fn.jobstart({"xdg-open", url}) -- linux
|
|
-- vim.ui.open(url) -- need Neovim 0.10.0+
|
|
end,
|
|
|
|
-- Optional, by default when you use `:ObsidianFollowLink` on a link to an image
|
|
-- file it will be ignored but you can customize this behavior here.
|
|
---@param img string
|
|
follow_img_func = function(img)
|
|
vim.fn.jobstart { 'qlmanage', '-p', img } -- Mac OS quick look preview
|
|
-- vim.fn.jobstart({"xdg-open", url}) -- linux
|
|
-- vim.cmd(':silent exec "!start ' .. url .. '"') -- Windows
|
|
end,
|
|
|
|
-- Optional, set to true if you use the Obsidian Advanced URI plugin.
|
|
-- https://github.com/Vinzent03/obsidian-advanced-uri
|
|
use_advanced_uri = false,
|
|
|
|
-- Optional, set to true to force ':ObsidianOpen' to bring the app to the foreground.
|
|
open_app_foreground = false,
|
|
|
|
picker = {
|
|
-- Set your preferred picker. Can be one of 'telescope.nvim', 'fzf-lua', or 'mini.pick'.
|
|
name = 'telescope.nvim',
|
|
-- Optional, configure key mappings for the picker. These are the defaults.
|
|
-- Not all pickers support all mappings.
|
|
note_mappings = {
|
|
-- Create a new note from your query.
|
|
new = '<C-x>',
|
|
-- Insert a link to the selected note.
|
|
insert_link = '<C-l>',
|
|
},
|
|
tag_mappings = {
|
|
-- Add tag(s) to current note.
|
|
tag_note = '<C-x>',
|
|
-- Insert a tag at the current location.
|
|
insert_tag = '<C-l>',
|
|
},
|
|
},
|
|
|
|
-- Optional, sort search results by "path", "modified", "accessed", or "created".
|
|
-- The recommend value is "modified" and `true` for `sort_reversed`, which means, for example,
|
|
-- that `:ObsidianQuickSwitch` will show the notes sorted by latest modified time
|
|
sort_by = 'modified',
|
|
sort_reversed = true,
|
|
|
|
-- Set the maximum number of lines to read from notes on disk when performing certain searches.
|
|
search_max_lines = 1000,
|
|
|
|
-- Optional, determines how certain commands open notes. The valid options are:
|
|
-- 1. "current" (the default) - to always open in the current window
|
|
-- 2. "vsplit" - to open in a vertical split if there's not already a vertical split
|
|
-- 3. "hsplit" - to open in a horizontal split if there's not already a horizontal split
|
|
open_notes_in = 'current',
|
|
|
|
-- Optional, define your own callbacks to further customize behavior.
|
|
callbacks = {
|
|
-- Runs at the end of `require("obsidian").setup()`.
|
|
---@param client obsidian.Client
|
|
post_setup = function(client) end,
|
|
|
|
-- Runs anytime you enter the buffer for a note.
|
|
---@param client obsidian.Client
|
|
---@param note obsidian.Note
|
|
enter_note = function(client, note) end,
|
|
|
|
-- Runs anytime you leave the buffer for a note.
|
|
---@param client obsidian.Client
|
|
---@param note obsidian.Note
|
|
leave_note = function(client, note) end,
|
|
|
|
-- Runs right before writing the buffer for a note.
|
|
---@param client obsidian.Client
|
|
---@param note obsidian.Note
|
|
pre_write_note = function(client, note) end,
|
|
|
|
-- Runs anytime the workspace is set/changed.
|
|
---@param client obsidian.Client
|
|
---@param workspace obsidian.Workspace
|
|
post_set_workspace = function(client, workspace) end,
|
|
},
|
|
|
|
-- Optional, configure additional syntax highlighting / extmarks.
|
|
-- This requires you have `conceallevel` set to 1 or 2. See `:help conceallevel` for more details.
|
|
ui = {
|
|
enable = true, -- set to false to disable all additional syntax features
|
|
update_debounce = 200, -- update delay after a text change (in milliseconds)
|
|
max_file_length = 5000, -- disable UI features for files with more than this many lines
|
|
-- Define how various check-boxes are displayed
|
|
checkboxes = {
|
|
-- NOTE: the 'char' value has to be a single character, and the highlight groups are defined below.
|
|
[' '] = { char = '', hl_group = 'ObsidianTodo' },
|
|
['x'] = { char = '', hl_group = 'ObsidianDone' },
|
|
['>'] = { char = '', hl_group = 'ObsidianRightArrow' },
|
|
['~'] = { char = '', hl_group = 'ObsidianTilde' },
|
|
['!'] = { char = '', hl_group = 'ObsidianImportant' },
|
|
-- Replace the above with this if you don't have a patched font:
|
|
-- [" "] = { char = "☐", hl_group = "ObsidianTodo" },
|
|
-- ["x"] = { char = "✔", hl_group = "ObsidianDone" },
|
|
|
|
-- You can also add more custom ones...
|
|
},
|
|
-- Use bullet marks for non-checkbox lists.
|
|
bullets = { char = '•', hl_group = 'ObsidianBullet' },
|
|
external_link_icon = { char = '', hl_group = 'ObsidianExtLinkIcon' },
|
|
-- Replace the above with this if you don't have a patched font:
|
|
-- external_link_icon = { char = "", hl_group = "ObsidianExtLinkIcon" },
|
|
reference_text = { hl_group = 'ObsidianRefText' },
|
|
highlight_text = { hl_group = 'ObsidianHighlightText' },
|
|
tags = { hl_group = 'ObsidianTag' },
|
|
block_ids = { hl_group = 'ObsidianBlockID' },
|
|
hl_groups = {
|
|
-- The options are passed directly to `vim.api.nvim_set_hl()`. See `:help nvim_set_hl`.
|
|
ObsidianTodo = { bold = true, fg = '#f78c6c' },
|
|
ObsidianDone = { bold = true, fg = '#89ddff' },
|
|
ObsidianRightArrow = { bold = true, fg = '#f78c6c' },
|
|
ObsidianTilde = { bold = true, fg = '#ff5370' },
|
|
ObsidianImportant = { bold = true, fg = '#d73128' },
|
|
ObsidianBullet = { bold = true, fg = '#89ddff' },
|
|
ObsidianRefText = { underline = true, fg = '#c792ea' },
|
|
ObsidianExtLinkIcon = { fg = '#c792ea' },
|
|
ObsidianTag = { italic = true, fg = '#89ddff' },
|
|
ObsidianBlockID = { italic = true, fg = '#89ddff' },
|
|
ObsidianHighlightText = { bg = '#75662e' },
|
|
},
|
|
},
|
|
|
|
-- Specify how to handle attachments.
|
|
attachments = {
|
|
-- The default folder to place images in via `:ObsidianPasteImg`.
|
|
-- If this is a relative path it will be interpreted as relative to the vault root.
|
|
-- You can always override this per image by passing a full path to the command instead of just a filename.
|
|
img_folder = 'assets/imgs', -- This is the default
|
|
|
|
-- Optional, customize the default name or prefix when pasting images via `:ObsidianPasteImg`.
|
|
---@return string
|
|
img_name_func = function()
|
|
-- Prefix image names with timestamp.
|
|
return string.format('%s-', os.time())
|
|
end,
|
|
|
|
-- A function that determines the text to insert in the note when pasting an image.
|
|
-- It takes two arguments, the `obsidian.Client` and an `obsidian.Path` to the image file.
|
|
-- This is the default implementation.
|
|
---@param client obsidian.Client
|
|
---@param path obsidian.Path the absolute path to the image file
|
|
---@return string
|
|
img_text_func = function(client, path)
|
|
path = client:vault_relative_path(path) or path
|
|
return string.format('', path.name, path)
|
|
end,
|
|
},
|
|
},
|
|
-- see below for full list of options 👇
|
|
}
|