A Zettelkasten note-taking plugin for Neovim, written in Lua.

• 📘 Intro
• ✨ Features
• 📦 Installation
• 🔧 Configuration
• ⚙️ Commands
• ⌨️ Key Bindings
  • Browser Window
  • Tags Sidebar
  • Note Buffer
• 🎨 Browser Format
• 🔍 Picker Integration
• 🔭 Telescope Integration
• 📅 Calendar Extension
• 💬 Chat Integration
• 🐞 Debug
• 📸 Screenshots
• 📣 Self-Promotion
• 🙏 Credits
• 💬 Feedback

zettelkasten.nvim brings Zettelkasten-style note-taking into Neovim. Notes are stored as Markdown files with timestamp-based IDs, and the plugin provides a browser window, tags sidebar, reference/backlink tracking, completion, and integrations with picker.nvim, telescope.nvim, calendar.nvim, and chat.nvim.

• 📝 Zettelkasten Notes - Create notes with timestamp-based IDs (YYYY-MM-DD-HH-MM-SS.md)
• 🗂️ Note Browser - Browse all notes in a dedicated window with customizable format
• 🏷️ Tags Sidebar - Foldable tag tree for visual tag-based filtering
• 🔗 References & Backlinks - Automatic [[note-id]] reference detection and backlink tracking
• ✏️ Completion - Note ID and tag completion via completefunc and tagfunc
• 📋 Quickfix Integration - List back references in the quickfix/location window
• 🖼️ Clipboard Image Paste - Paste images from clipboard directly into notes (macOS/Linux/Windows)
• 🔍 Multi-Picker Support - Integrates with picker.nvim and telescope.nvim
• 📅 Calendar Integration - Highlights dates with notes via calendar.nvim
• 💬 Chat Integration - Create and retrieve notes via chat.nvim
• 🧩 Note Templates - Create notes from pre-defined templates

Using nvim-plug:

require('plug').add({
    {
        'wsdjeg/zettelkasten.nvim',
        config = function()
            require('zettelkasten').setup({
                notes_path = '~/.zettelkasten',
                template_dir = '~/.zettelkasten_template',
                preview_command = 'pedit',
                browseformat = '%f - %h [%r Refs] [%b B-Refs] %t',
            })
            vim.keymap.set('n', '<leader>mzb', '<cmd>ZkBrowse<cr>', { silent = true })
            vim.keymap.set('n', '<leader>mzn', '<cmd>ZkNew<cr>', { silent = true })
        end,
    },
})

Using LuaRocks:

luarocks install zettelkasten.nvim

All options are passed to require('zettelkasten').setup({}):

The browseformat option controls how each note is displayed in the browser window. The following modifiers are supported:

zettelkasten.nvim provides sources for picker.nvim:

:Picker zettelkasten
:Picker zettelkasten_tag
:Picker zettelkasten_template

Key bindings in picker sources:

zettelkasten.nvim also provides extensions for telescope.nvim:

require('telescope').load_extension('zettelkasten')
require('telescope').load_extension('zettelkasten_tags')
require('telescope').load_extension('zettelkasten_template')

zettelkasten.nvim provides an extension for calendar.nvim. It highlights dates that have zettelkasten notes associated with them.

When pressing <Enter> on a date in the calendar, the following actions are available:

1. Create a daily note - Creates a new note with the selected date
2. Browse daily notes - Opens the browser filtered by the selected date

zettelkasten.nvim provides two tools for chat.nvim:

@zk create <title>

Creates a new zettelkasten note with automatic ID generation and tag support.

Parameters:

• title (string, required): The title of the note
• content (string, required): The main body content of the note
• tags (array of strings, optional): Tags for categorizing the note (e.g., ["programming", "vim"])

The note file is formatted as:

# <id> <title>

tags: #tag1 #tag2

<content>

@zk get <tags>

Retrieves zettelkasten notes by tags. Returns a JSON array of matching notes with file_name and title fields.

Debug zettelkasten.nvim with logger.nvim:

require('plug').add({
    {
        'wsdjeg/zettelkasten.nvim',
        depends = { { 'wsdjeg/logger.nvim' } },
    },
})

Like this plugin? Star the repository on GitHub.

Love this plugin? Follow me on GitHub.

This plugin is forked from Furkanzmc/zettelkasten.nvim.

New features added in this fork:

• Tags sidebar with foldable tag tree for visual filtering
• Tag completion in completefunc (detects # prefix context)
• Clipboard image paste (macOS / Linux / Windows)
• Note templates and custom-date note creation via zknew(opt)
• Calendar.nvim, picker.nvim, telescope.nvim, and chat.nvim integrations
• LuaRocks support and release-please automation

Improvements over upstream:

• Nil-safety and file-handle cleanup in note parsing
• Duplicate note ID guard in set_note_id
• Read-only browser buffer with richer keybindings (q, <Enter>, <C-l>, <F2>)
• CJK-aware title truncation in the browser formatter
• Simplified config (module-level fields instead of config.get())
• Comprehensive unit test suite with luaunit

If you encounter any bugs or have suggestions, please file an issue in the issue tracker.