#vimwiki

@tzovar.as.web.brid.gy

3 months ago

Taking linked notes with Vimwiki and integrating it with Forgejo wikis A couple of days ago, I stumbled over a Mastodon post by @johl, in which he shared `vimwiki` as his approach for taking notes in `vim`. Which immediately piqued my interest, as I have so far been just taking my notes in plain `vim` without a way of linking them. While I’m not someone that really uses (or feels any benefits from) _second brain_ note-taking1, I do take enough project-related notes that being able to cross-reference prior notes could be useful for me. And in the process of trying, I also found out that it also works great for interacting with `forgejo` wikis – as e.g. used in many FLOSS projects on Codeberg.2 _Vimwiki_ allows you to set up one or multiple folders as (different) wikis. When opening a Wiki, you can create a link to another existing or new file, by just pressing `<Enter>` in normal `vim` mode. Pressing `<Enter>` when the cursor is over an existing link opens that file, `<Backspace>` takes you back to the prior page. Plus, there’s a _diary_ function, where one can create pages for specific dates, which can handle daily note-taking, to-do lists with checkboxes etc. By default, _Vimwiki_ uses its own syntax for taking notes, which seems to be a dialect/mashup of _Markdown_ and _MediaWiki_ formatting. But it also supports _Markdown_ and _MediaWiki_ as optional syntax settings. The support for _Markdown_ is particularly key for me, as I’m already taking all my notes using that particular format, so there’s very little additional learning required. It just requires a little bit of setup in your `vim` settings to make it use _Markdown_ formatting and use `*.md` as the file extension. Plus, the folding of `vim-markdown` can be made to work too, which is useful for larger wiki pages. The other benefit of using _Markdown_ , given my pre-existing setup, is that I have already written _Markdown_ templates that can be chosen when editing a new `*.md` file in `vim`. Beyond having templates for blog posts (like this one) – that provide all the necessary front matter – I also have a note-taking template for daily notes & todos. It automatically fills in the current date as a top-level heading, and creates a section for to-do items and notes. There is one more cool feature that comes with using _Markdown_ as the syntax for _Vimwiki_ : _Forgejo_ , the forge software that powers e.g. _Codeberg_ , has a feature for hosting wikis alongside code repositories. These wikis in turn are just their own Git repositories that collect a bunch of – you have guessed it – _Markdown_ files. This means you can just check the wiki out locally, and set it up to be used as an extra wiki inside _Vimwiki_. Such a joint _Forgejo_ & _Vimwiki_ setup allows you to pull/push changes from/to _forgejo_ and locally interact with the wiki right in `vim`. You can see a toy example in my `vim` configuration repo. _Forgejo_ wikis also have some _special_ page names, including `Home` for the _frontpage_. If you setup your local `vimwiki` configuration to use `Home` as the name of the `index` page, your local wiki will also default to using the _correct_ page when opening the wiki (see my example setup). Lastly, _Vimwiki_ can also do a full export of all of your wiki pages into HTML, structured as to allow you to still follow the internal links and ready to be put on some web server. By default, the exporter works for the internal _Vimwiki_ format, but there’s a rich set of options to also export _Markdown_. As most of my tooling is based on _Python_ , I went with that flavor of _vimwiki_markdown_, alongside the `markdown-checklist` to allow for correctly formatting to-do items. To make this work, the `custom_wiki2html` parameter needs to be set, and the checklist plugin needs to be loaded. When those are done, one can export all pages via `:VimwikiAll2HTML`. So far, I’ve been enjoying the _Vimwiki_ integration. It’s great to be able to quickly go back and forth between notes, and also to have them right at my fingertips when writing/editing other docs in `vim`. Plus, being able to more quickly interact with externally hosted & displayed wikis on _Forgejo_ is great for editing those in a more comfortable place than the web interface. ## References * Greshake Tzovaras, B. (2025, February 18). Using vim templates for markdown writing. Bastian Greshake Tzovaras. https://doi.org/10.59350/qfa6t-c645 ## Footnotes 1. After many failed attempts, I’m convinced that there’s just large differences in how people’s brains work for note-taking. I know some people swear by tools like _Roam_ , _Obsidian_ et al. but I have tried many of them, but they just don’t work for me. ↩ 2. I’m sure it would work for _GitHub_ wikis too, but I haven’t tried and don’t plan on doing so. ↩

0 0 0 0

Dev Albino :python:

@v-raton.bolha.us.ap.brid.gy

4 months ago

Original post on bolha.us

Ces fizeram essa pra min foi?

#ttersoftware de linha de comnado eu vou é de combo do street fight:

O primeiro é o #tmux (tmux) pra multiplexar o terminal e ter várias abas: https://github.com/tmux/tmux

O segundo é o #neovim (neovim) pra edittar meus textos https://neovim.io/

O terceiro é o […]

0 0 0 0

Dev Albino :python:

@v-raton.bolha.us.ap.brid.gy

5 months ago

Original post on bolha.us

#tersoftware de coisas que não precisam de nuvem....

Vou trazer combos

#KepassXC para suas senhas + #syncthing para sincronizar entre dispositivos usando rede local

#neovim + #vimwiki + #printnotes para uma wiki pessoal offgrid tanto no desktop quanto no mobile

Seguem os links:

KeepassXC […]

0 2 0 0

dharmik

@dharmik.linuxusers.in.ap.brid.gy

6 months ago

Original post on linuxusers.in

they say you shouldn’t love something too much, because it’ll hurt to let it go. maybe they’re right. my love for #neovim runs deep, and even the thought of not using #vimwiki and moving somewhere else feels like betrayal. still, nb is tempting with its support for so many color themes. i could […]

0 0 0 0

dharmik

@dharmik.linuxusers.in.ap.brid.gy

6 months ago

Original post on linuxusers.in

one of the growing pains of #vimwiki is that i like it too much. i even use it to deploy my wiki on my site (dhrm1k.github.io/wiki). the problem is that every time i generate html for my wiki, i am required to separate what’s personal from what goes online, i need to tweak the build source in my […]

0 0 1 0

DevInTheMtn 🐧

@devinthemtn.bsky.social

6 months ago

I am using to using vimwiki on neovim for notes and love it but i've been switching to Zed for everything else. Does anyone have recommendations on if there is something similar for Zed?

#vim #zed #vimwiki #pkm

0 0 0 0

Kevin Lyda

@lyda.mastodon.ie.ap.brid.gy

10 months ago

Original post on mastodon.ie

Trying #GitJournal with my markdown notes I manage in #VimWiki (thanks again to @vkc - VimWiki is awesome). But it seems to get confused creating notes.

I have the VimWiki repo in my home vcsh repository so it has a whole bunch of files besides the markdown ones. I can look at splitting it out […]

0 0 1 0

Nimona RESISTS

@valen1.mstdn.social.ap.brid.gy

11 months ago

vkc (Veronica Explains) (@vkc@linuxmom.net) 1.43K Posts, 526 Following, 13.4K Followers · I make dorky YouTube/PeerTube videos about Linux and vintage tech, and occasionally write about stuff. I'm also a geeky musician and used to be a COBOL dev. Pronouns are she/her. Proudly supported by viewers like you via Patreon and Ko-Fi. Thank you for your consideration! (Note: posts here may self destruct, and my notifications are mostly muted- can't reply to everyone. Don't take it personally.)

The always awesome Veronica @vkc has a new video. This one is on #vimwiki, which is a great way of taking notes and such. I loves #wikis so much! Anyway, heres the link: https://tinkerbetter.tube/w/6hrXmYYNMjBGJnSE8iJ6NM

0 0 0 0

Posts tagged #vimwiki