nvim-µwiki

A minimalist plugin to add basic wiki functions to Markdown documents.

✨ Features

Relevant function names in parentheses

• Jump the cursor between wiki-links (enclosed in double-braces, e.g. [[this]]) in a document (prevWikiLink, nextWikiLink)
• Follow wiki-links to existing pages where they exist, or start editing empty buffers (maybeFollowWikiLink)
• Quickly edit a page corresponding to Today's date (todayDatePage)
• Quickly Navigate to previous/next days from any page with a filename matching %Y-%m-%d e.g. 2025-01-23 (prevDatePage, nextDatePage)
• Populate the tag stack as you follow wiki-links
• Don't take over the FileType: play nicely with any other Markdown configuration or plugins you are using.

⚡️ Requirements

• Neovim. This has been developed with version 0.10.0.
• This Treesitter grammar for markdown. It's bundled with Neovim since version 0.10.0.

📦 Installation

Use your favourite plugin manager. I'm using vim-plug. E.g.:

call plug#begin()
  Plug 'jmtd/nvim-microwiki'
call plug#end()

⚙️ Configuration

vim.api.nvim_create_autocmd('FileType', {pattern='markdown', callback=function(args)

    -- You need to have TreeSitter enabled for Markdown documents. (This
    -- isn't needed for neovim >= 0.12.0, where it is enabled by default).
    vim.treesitter.start(args.buf, 'markdown')

    -- nvim-µwiki determines your preferred file extension by reading the
    -- first value from vim's existing `suffixesadd` option
    vim.opt_local.suffixesadd = { ".mdwn" , ".md" }

    -- Here are some suggested key mappings:
    local wiki = require("nvim-µwiki")
    vim.keymap.set('n', '<leader>wd', wiki.todayDatePage)
    vim.keymap.set('n', '<C-]>',      wiki.followWikiLink,      {buffer = true})
    vim.keymap.set('n', '<CR>',       wiki.maybeFollowWikiLink, {buffer = true})
    vim.keymap.set('n', '<Tab>',      wiki.nextWikiLink,        {buffer = true})
    vim.keymap.set('n', '<S-Tab>',    wiki.prevWikiLink,        {buffer = true})
    vim.keymap.set('n', '<C-Down>',   wiki.nextDatePage,        {buffer = true})
    vim.keymap.set('n', '<C-Up>',     wiki.prevDatePage,        {buffer = true})

end })

🧐 See also

• Vimwiki: fully featured VimScript wiki
• Potwiki: VimScript wiki of text files

Authors

• Copyright © 2025-2026 Jonathan Dowland, all rights reserved.

Distributed under the GNU General Public License, version 3. See LICENSE.