github-markdown-toc VS nb

As for the table of contents, you can either use github-markdown-toc or markdown-toc (on npm).

A longer README may seem daunting but it will be indexed better by search engines. Include a generated table of contents for quick navigation.

A few tools I've come across that I've used.

Doing [1] by Brett Terspstra; "A command line tool for keeping track of what you’re doing and tracking what you’ve done."

NA [2] (Next Action) also by Brett Terpstra; "A command line tool for adding and listing per-project todos."

nb [3] is "a command line and local web note‑taking, bookmarking, archiving, and knowledge base application"

nb supports multiple notebooks, Git-based version control and a bunch of other things

[1]: https://brettterpstra.com/projects/doing/

[2]: https://brettterpstra.com/projects/na/

[3]: https://xwmx.github.io/nb/#home

I use [nb](https://github.com/xwmx/nb). It's a CLI tool (easy to write a GUI for if you want one) that is fast, uses Git to version control things, and handles more than just bookmarks. I sync across computers using Dropbox.

Depending on how minimal you want to go, nb is viable, but any “features” you’d have to script yourself. https://xwmx.github.io/nb/

I found xwmx's `nb` which I quite like for its git remote integration and tools, but I find it somewhat clunky to interact with. On top of this, I am relatively inexperienced with vim, would like to keep my config very simple, and have no idea how to integrate `nb` with vim directly.

It depends on your needs, but give nb a try: * https://xwmx.github.io/nb/

xmwx/nb