How to Keep a Structured Markdown Journal Using Vimwiki

Journaling has long been an effective way to reflect, track tasks, and document ideas or conversations. But if you’re a terminal-based user who enjoys the minimalism of Vim, Markdown, and data ownership — you’re in luck. In this post, you’ll learn how to set up a lightweight, private, and highly productive journaling system using vimwiki, all in plain text files synced via Nextcloud.

Whether you’re logging calls, capturing thoughts, or tracking your daily wins, this setup will help you keep everything organized — without giving up control to a third-party app.

Changelog

Why Use Vimwiki for Journaling?

vimwiki is a Vim plugin that transforms your editor into a personal wiki. It’s lightweight, fast, and supports:

• Daily journal entries (diary mode)
• Linked notes for projects or topics
• To-do lists and simple task tracking
• Markdown syntax for compatibility
• Full offline access — works with Nextcloud or any sync service

If you’re already storing notes in Markdown, this is a perfect upgrade.

Step 1: Install vimwiki

Using vim-plug (or your plugin manager of choice), add this to your .vimrc:

Plug 'vimwiki/vimwiki'

Then launch Vim and run:

:PlugInstall

If you’re not using vim-plug, check the installation instructions here.

Step 2: Configure Vimwiki to Use Markdown

In your ~/.vimrc, configure vimwiki to store files in a Markdown format inside your Nextcloud folder. This configuration is cleaner and easier to maintain.

" Vimwiki Configuration
let g:vimwiki_list = [{
  \ 'path': '~/Nextcloud/Notes/wiki/', " Path to your wiki's root folder
  \ 'syntax': 'markdown',             " Use Markdown syntax
  \ 'ext': '.md'                      " Use .md as the file extension
\}]

" Ensures that created links include the .md extension for better compatibility
let g:vimwiki_markdown_link_ext = 1

" Automatically creates an index of all diary entries
let g:vimwiki_auto_diary_index = 1

Create the necessary folders manually if they don’t exist:

mkdir -p ~/Nextcloud/Notes/wiki/diary

Step 3: Creating and Accessing Your Daily Journal

The core of your journaling workflow is creating or opening the note for the current day. Here are the best ways to do it.

The Basic Command

The fundamental command to create or open today’s journal entry is:

:VimwikiMakeDiaryNote

This command will create a file like ~/Nextcloud/Notes/wiki/diary/2025-06-21.md if it doesn’t exist, and open it otherwise.

Recommended Methods for Quick Access

While the basic command works, typing it every time is impractical. For a fast and efficient workflow, use these shortcuts instead.

Method 1: From Inside Vim (The Fastest Way)

vimwiki comes with a built-in keyboard shortcut that is perfect for daily use. While in Vim’s normal mode, simply press:

<leader>w<leader>w

This is the most efficient way to open your journal when you are already working in Vim. The <leader> key is typically the backslash (\) by default.

Method 2: From Your Terminal

For moments when you want to jump directly into your journal from the command line, a shell alias is the perfect tool. Add this line to your .bashrc or .zshrc file:

alias journal='vim -c "VimwikiMakeDiaryNote"'

After reloading your shell, you can now simply type journal in your terminal. This will launch Vim and immediately open today’s diary entry, applying your template if it’s a new day.

Example Entry

Regardless of which method you use to open it, your daily note will look something like this:

# 2025-06-21

## 09:02 – Call with Sarah
Discussed the project milestones. Need to follow up next Tuesday.

## 13:45 – Idea
Use `jrnl` CLI for quick journal entries via terminal.

## 20:15 – Reflection
Today was productive. Really enjoying the new Vim-based workflow.

Step 4: Create and Follow Internal Links

Link to another page in your wiki using vimwiki’s native syntax:

[[Project Alpha]]

Pressing Enter on this link will create and navigate to Project Alpha.md.

For universal compatibility with other Markdown editors (like Obsidian or QOwnNotes), you can use a standard Markdown link. vimwiki will still follow it if you press Enter.

[Project Alpha](Project%20Alpha.md)

The key difference is that [[Project Alpha]] is deeply integrated into vimwiki’s features (like backlinking), while the standard link is more portable across different applications.

Step 5: Create a Diary Template (Optional)

Add a default template for your daily entries. It’s best practice to store the template in your wiki’s root directory.

1. Create the template file: ~/Nextcloud/Notes/wiki/template.md

   Important: vimwiki uses strftime format codes, not {{placeholders}}.

   # %Y-%m-%d
   
   ## ☎️ Calls
   
   ## 💡 Ideas
   
   ## ✅ Tasks
   
   ## 📌 Notes
   
   ## 🔁 Reflection
   

2. Add this line to your .vimrc. Using a relative path makes your config more robust.

   let g:vimwiki_diary_template = 'template.md'
   

Every new diary file created with :VimwikiMakeDiaryNote (or the shortcuts) will now use this layout.

Bonus Tips

• Manage To-Do Lists: vimwiki has excellent support for task lists. Use g<Space> on a list item in Vim to cycle through states.

  - [ ] An open task
  - [.] A task in progress
  - [X] A completed task
  

• Quick Navigation: After following a link, press Ctrl-O to go back to the previous location and Ctrl-I to go forward.
• Diary Index: Use :VimwikiDiaryIndex to open the diary/index.md — a central view of all your entries.
• Search: Use :VimwikiSearch KEYWORD to find entries across your entire wiki.
• Syncing: Sync your wiki/ folder with Nextcloud, and view or edit it from mobile apps like Markor (Android) or 1Writer (iOS).

Summary

With vimwiki, you can build a minimal yet powerful journaling system:

✅ Fully Markdown-compatible
✅ Terminal- and Vim-native
✅ Works offline and syncs via Nextcloud
✅ Extendable with links, to-do lists, templates, and more

No bloated app, no subscription, no cloud lock-in.