zk

A plain text note-taking assistant

Looking for a quick usage example? Let's get started.

Description

zk is a command-line tool helping you to maintain a plain text Zettelkasten or personal wiki.

Highlights

• Creating notes from templates
• Advanced search and filtering capabilities including tags, links and mentions
• Integration with your favorite editors:
  • zk.nvim for Neovim 0.5+, maintained by Seth Messer
  • zk-vscode for Visual Studio Code
  • Any LSP-compatible editor
• Interactive browser, powered by fzf
• Git-style command aliases and named filters
• Made with automation in mind
• Notebook housekeeping
• Future-proof, thanks to Markdown
• Supports most Markdown syntax flavors
  • Links: regular Markdown links, [[Wikilinks]] and Neuron's [[Folgezettel links]]#.
  • Tags: #hashtags, :colon:separated:tags:, Bear's #multi-word tags#.
  • YAML frontmatter

See the changelog for the list of upcoming features waiting to be released.

What zk is not

• A note editor.
• A tool to serve your notes on the web – for this, you may be interested in Neuron or Gollum.

Install

Check out the latest release for pre-built binaries for macOS and Linux (zk was not tested on Windows).

Build from scratch

Make sure you have a working Go installation, then clone the repository:

$ git clone https://github.com/mickael-menu/zk.git
$ cd zk
$ chmod a+x go

On macOS

icu4c is required to build zk, which you can install with Homebrew.

$ brew install icu4c
$ ./go build
$ ./zk -h

Apple Silicon

The build command needs additional environment variables on Apple Silicon:

$ GOARCH=arm64 CGO_CFLAGS="-I/opt/homebrew/opt/icu4c/include" CGO_LDFLAGS="-L/opt/homebrew/opt/icu4c/lib" ./go build

On Linux

libicu-dev is required to build zk, use your favorite package manager to install it.

$ apt-install libicu-dev
$ ./go build
$ ./zk -h

Related projects

• Neuron – a great tool to publish a Zettelkasten on the web
• sirupsen's zk – a collection of scripts with a similar purpose