Conceptual Note-Taking
Vim Note-Taking — A better way to take notes. Writing about conceptual notes, and the strategies I use to take class notes efficiently. 2023-01-28
Some Updates
Since last posting about my conceptual notes, I have switched to using Neovim as my primary text editor, which you can read more about here. My configuration for Neovim is part of my dotfiles, which can be found on my GitHub. I have also started using Obsidian for previewing my notes as it does not require superfluous configuration for the superset of Markdown I use, which includes [wiki links](wiki%20links.md) and $\LaTeX$ equations.
Publishing my Notes
One inconvenient to using plain-text Markdown files for my conceptual notes is that it makes it difficult to share them with others. Sending GitHub links is one solution, but GitHub supports neither LaTeX equations nor wiki links. I knew I needed a better solution.
Some of the advantages of using Markdown for note-taking is that it is future-proof and highly portable. Markdown is used to create websites (such as the one you are on right now), technical documentation, presentations, email messages, and the list goes on. This is what made it so trivial to publish my notes to the internet. I used a library called mkdocs, which is a static site generator for Markdown documentation. I feed it the output of Obsidian Export to convert Obsidian-style Markdown down to CommonMark. If you are interested in learning more about how this process works, check out my note's GitHub repository!
The Result
After a few client-side JavaScript patches, the result is this website. It is definitely not perfect, but it is still a good way to quickly share my notes with others. Feel free to explore around, and let me know what you think!