Changed my note-taking tool

I have been using Microsoft OneNote tool about ten years and I have several Notebooks (personal and work related). Mostly I use note-taking tool for documenting stuff for myself (code samples, architecture patterns, memos, tips and tricks and random notes). I like to write notes and I have a lot of them:). OneNote has been a good tool for note-taking but now I wanted to test something else.

OneNote pros and cons

I listed below a few highlights and pain points from my point of view when using OneNote.

What I expect from the new note-taking tool?

1. No vendor lock

Notes should be easily moved to the another note-taking tool without doing scripting and complex migration.

2. Markdown support

I have been using markdown syntax for a while in work projects to document different kind of technical things like configuration steps, readme notes and diagrams as well. I really like simplicity of markdown and how it forces your notes to the strict controlled format. Actual markdown syntax is really fast to learn and you're well qualified markdown note-writer when you have learned basic things like headings, block quotes, lists, links, image references and adding code snippets. You can read more about syntax from here (Markdown Cheat Sheet).

3. Hierarchy and searchability

Notes must be possible to organize hierarchically and hierarchy must be deep enough. Tagging or categorization of the notes is also must have feature to increase searchability.

4. Simplicity and extensibility

Note-taking tool should be fairly simple & light and user experience can be even ascetic. Functionalities should be extended necessary with add-ons or extensions. 

5. Privacy

Notes data may not be used for any commercial or advertisement purposes and end-to-end encryption should be also supported.

Which tool fulfilled my expectations?

I investigated multiple markdown supported note-taking tools but Visual Studio Code felt best for my purpose. It clearly fulfills all my requirements. Of course it's important to remember that this is not ready out-of-box solution. You have spend time to configure and install required extensions and even use third party applications to implement additional features like end-to-end encryption. 

Markdown files and VS Code

VS Code supports markdown files out of the box and markdown files are stored to hard drive as a plain text. You can easily change folder hierarchy in the VS Code and changes are reflected immediately to hard disk. This approach enables that folders and markdown files are easy to backup and maybe later migrate to another note-taking application (preventing vendor locks). 

Extensions

Visual Studio Code has a livid community which has produced huge number of different kind of extensions. I installed the following extension to improve note-taking experience.

Mermaid extension adds support to embed Mermaid diagrams to markdown files. This is very useful extension to create quickly diagrams and flowcharts if you don't want to use Draw.io.

Extra layer of security

You can use tools like Cryptomator to create Vault where notes files are stored. Cryptomator Vault content is encrypted with a key selected by you. After that you can sync Cryptomator Vault to the cloud service like OneDrive.

Workspaces

A Visual Studio Code "workspace" is the collection of one or more folders that are opened in a VS Code window (instance). This concept enables to apply different kind of predefined settings to folders. Read more about workspaces from here. I have used the following workspace settings to hide png-images from the VS Code's Explorer view. This keeps VS Code's Explorer more cleaner because it basically shows only folders or markdown files.

{
	"settings": {
		"files.exclude": {
			"**/*.png": true
		}
	}
}

Beginning of the journey

Now new note-taking journey has started and let's see how it goes:).