With an overwhelmingly increasing number of productivity tools and note-taking applications on the market, it is becoming more and more difficult to settle on one particular application / workflow for taking notes. Over the years, I've tried many many setups for this: from pen and paper (which still beats everything in my opinion) to completely offline solutions like txt files, VimWiki, Zettlr and MarkText, Joplin and SaaS products like this one and methods like Zettelkasten (this didn't work for my programming notes), I've tried a plethora of apps that are out there. For the past few months however, I've settled on a simple workflow that I'll explain below.
Disclaimer: I am not a researcher who has to read multiple academic papers everyday and annotate things for later use. This is just my current note-taking setup that works for me.
First, let's look at the high level overview of what my notes consist of (yet). There are typically 3 kinds of notes that I take:
The first two kinds of notes are kind of permanent notes that I'd like to persist for as long as possible. The last kind consists of temporary information and tasks. For all types of notes, I like a simple and lightweight markup language, namely Markdown. Markdown is supported by all major static site generators (in case I want to turn my notes into websites for other folks to use) and learning Markdown takes virtually no time.
Secondly, here are the features I'm looking for in my workflow:
I have a compulsive urge to collect any new website that I come across that sparks my curiosity and meets a few standards. As of now, there are more than 3000 websites in my collection.
For this, I have a bunch of markdown files in a folder with filenames matching the top level category that each website goes into. Inside each of those files, there are sub-categories and nested hierarchies of lists with more and more specific criteria for categorization.
I use Neovim / Gedit for writing Markdown because these editors don't auto-format my markdown files on save like VSCode does by default. This is a digital version of my collection from my notebook way back.
Anyway, this repo consists of what I like to call my "public" bookmarks. I put this on GitHub for everyone to take advantage of and explore what the internet has to offer. So, if you're interested, go check it out.
A question I get asked a lot is isn't this time consuming to categorize and maintain a repo like this? Well, I don't do all the manual work of writing Markdown, and copy pasting links and descriptions for resources, etc. I have a few bookmarklets, vim macros, and scripts that do the formatting for me.
I use an internal web extension that recursively exports a specific folder from my bookmarks on Firefox to properly formatted Markdown (aside: I am working on publishing this addon with added functionality) and copy those links into whatever files they should go to. While browsing, I drag new websites to that folder on my Bookmarks Toolbar and at the end of the week, load the extension and export the data. This takes ~30 minutes per week. Then, I push the updates to GitHub and Travis does all the work of building the website (I use mdBook for this) and deployment is done via GitHub Pages.
I have always been a Firefox user. I use Firefox Developer Edition as my primary browser. For links that I'd rather not share with the world, I use Firefox Sync. There are multiple folders and hierarchies with weird names that I personally use to sort my bookmarks. For example, I use it to store:
For outsiders, this approach might seem time-consuming and unnecessary but as a privacy conscious person, I find it to be the best solution that aligns with my personal threat model.
It also has added benefits like I can store my data in as many nested folders and tags as I can think of. I don't have to log into big corporate websites to view something and I can sync my bookmarks on all my devices in an end-to-end encrypted way in milliseconds. This method helps me decrease the digital footprint I leave on the Internet and less amount of data tied to big companies.
If I want to export all my bookmarks to Markdown, I can use Firefox's Export Bookmarks to HTML feature and use a tool like pandoc to convert HTML to Markdown.
But what about links that I want to check out later on my laptop while I'm browsing let's say, HN on my phone? I can use Firefox Sync for this as well but the experience isn't so good. I try to minimize my use of my phone for tasks that I'd like to do on my computer but for such use cases, I use a "Read It Later" service called Pocket (This isn't open source, but it's owned by Mozilla and these folks seem to be more trustworthy than most other companies). I am thinking of eventually switching to a self-hosted alternative like wallabag but I'm not in a position to do so right now. I use tags to manage links in Pocket. Also I can export my Pocket list to HTML via Pocket's Export tool and import the links to Firefox with ease.
I also use Pocket as an alternative to YouTube's "Watch Later" and IMDb's "Watchlist" features.
Aside: I do use Twitter, not for microblogging but to follow interesting accounts. Their recommendation system is pretty good for this sort of thing. As for Spotify, I hate the fact that it is so closely tied to Facebook. They log all search queries even after deleting your search history. I have deleted all my Spotify Playlists (I can't even delete them permanently) and exported the data to Firefox (using Exportify). I need to find a better solution for Music (I'm trying out this service.).
These consist of information I extract from reading (non-fiction) books, articles, watching YouTube videos, quotes, etc.
Again, I just have a folder with a bunch of Markdown files that I write my notes in. I currently publish these notes here and use Docusaurus for generating the website and GitHub Pages for deployment.
These notes consist small snippets of code, shell scripting and programming tips, Linux commands that I frequently use, IRC commands that I tend to forget all the time, etc. Essentially, these are little pieces of random information for personal use that aren't tied to me personally or summaries of books I read and that I think someone will benefit from reading.
This is where my most personal data and notes reside. I use an open-source note-taking service called Standard Notes for this. This provides automatic end-to-end encryption for my notes, free sync across my devices and the "Extended" tier has some amazing features like Code editor, vim mode, spreadsheet, etc. They have a web app that I open in a new browser window when I am reading an information-dense piece on the internet or non-fiction books. And they also have clients for Linux and other OSes. Their free tier has all the core features that I need. It is privacy focused, lightweight, has a simple intuitive interface and is a breeze to write my notes on.
On my phone, I use Standard Notes for both public and private notes that I can later sort out on my computer.
I manage highly sensitive information like Recovery codes, Paper keys, API keys, etc with a password manager. I recommend Bitwarden.
The other kinds of notes (well, these are what I consider to be notes) are my dotfiles and this blog. I try to document everything on my config files so I can understand what each line of configuration is doing. I store these on GitHub and use a technique I learned from HN to manage my config files.
For this blog, I use GatsbyJS along with gatsby-transformer-remark and gatsby-source-filesystem plugins that allow me to read Markdown files from the filesystem and generate HTML pages from these files. I will write more on setting up this site in a future blog post.
I use Standard Notes for these as well. A better solution for todos would be something like Tasks.org but this just adds one more application to my setup and phone. For temporary grocery list and stuff, I use the default Notes app that comes with my phone (in offline mode) and for long-term todos, I use Standard Notes and special tags. I append special characters to the start of each todo. For example, here's is an entry from one of those notes:
- $$$ add Plausible/Goatcounter analytics for website, remove Google Analytics.
This is something I'd like to do in the future (my apologies) but I am currently limited by costs (indicated by $$$).
In a nutshell, most of my notes are stored in Markdown files inside folders on my hard drive. I use Neovim and Gedit to edit these notes and Git for version control and sync. I share some of them with the world, and for private notes, I use end-to-end encrypted services: Firefox Sync, Standard Notes and Bitwarden. I use Pocket to save and sync links that I want to read later.
By the way, I still carry a notepad and pen with me for cases when I don't have access to my phone or the Internet.
I might change anything anytime but this is basically what my note-taking setup looks like right now. This might seem like nothing new, too much organization / work, completely crazy or unnecessary. Please don't hesitate to contact me if you have anything to add.