Repolode
Submit
xwmx

xwmx/nb

A command-line and local web note-taking, bookmarking and knowledge base tool, packed into a single portable shell script.

Open-source alternative to:EvernotePocket

View on GitHubWebsite
Stars
8,453
Forks
258
Open issues
154
Last commit
2 months ago

What is it?

nb is a note-taking, bookmarking and archiving application that runs from the terminal and can also be browsed through a local web interface. Notes are stored as plain text files, including Markdown, Org, LaTeX and AsciiDoc, and can be edited with any text editor.

Bookmarks are downloaded, cleaned up and saved as Markdown documents, with local full-text search over cached page content and Internet Archive Wayback Machine lookup for broken links. Notes support tagging, pinning, folders, filtering, wiki-style [[linking]], encryption with OpenSSL or GPG, and todos.

Versioning and syncing use Git in the background, and notebooks can also be synced through tools such as Dropbox. Pandoc-backed conversion handles import and export, and the whole program is one shell script that works on Linux, Unix, macOS, and Windows through WSL, MSYS or Cygwin.

Key features

  • 01Plain text storage in Markdown, Org, LaTeX and AsciiDoc formats.
  • 02Bookmark saving with local full-text search and Wayback Machine lookup.
  • 03Git-backed version history and syncing between devices.
  • 04Password-protected encrypted notes using OpenSSL or GPG.
  • 05Tagging, pinning, folders, and wiki-style linking between notes.
  • 06Pandoc-based conversion for importing and exporting documents.

Use cases

  • Keeping a personal Markdown knowledge base in a Git repository.
  • Saving and searching web bookmarks from the terminal.
  • Writing notes in your preferred editor such as Vim or VS Code.
  • Storing encrypted personal notes with tools you can decrypt independently.

Topics

#note-taking#bookmarks#cli#markdown#git#knowledge-base#shell#pandoc#archiving#bash

FAQ

What is nb?
A command-line and local web note-taking, bookmarking and knowledge base tool, packed into a single portable shell script. nb is a note-taking, bookmarking and archiving application that runs from the terminal and can also be browsed through a local web interface. Notes are stored as plain text files, including Markdown, Org, LaTeX and AsciiDoc, and can be edited with any text editor.
Is nb free to use? What license does it have?
nb is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is nb still maintained?
Updated within 6 months. The last commit to nb was on Aug 26, 2026.
What can I use nb for?
Keeping a personal Markdown knowledge base in a Git repository. Saving and searching web bookmarks from the terminal. Writing notes in your preferred editor such as Vim or VS Code. Storing encrypted personal notes with tools you can decrypt independently.
Where can I get nb?
The source code and installation instructions are on GitHub: https://github.com/xwmx/nb

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects