Math Formulas in Markdown

Forketyfork
3 min readSep 3, 2021
Image by Elchinator from Pixabay

In this article, I’d like to share my setup for writing notes in Markdown with mathematical formulas using LaTeX syntax. I use vim and neuron for that. I mostly work on Mac, but the setup for my Linux laptop doesn’t differ significantly.

neuron for notes

neuron implements a note-taking approach called Zettelkasten. There’s a lot to be said about this great tool (including that it’s soon going to be superseded by even cooler Emanote). But for this article, I’m only focusing on its ability to generate neat HTML pages with mathematical formulas based on Markdown and LaTeX syntax.

First, I install the Nix package manager using this guide for macOS. As soon as it’s ready, I enable Nix cache for neuron and install neuron itself according to the docs:

nix-env -iA cachix -f https://cachix.org/api/v1/installcachix use sridnix-env -if https://github.com/srid/neuron/archive/master.tar.gz

I then create a folder for my notes and put an empty neuron.dhall file there:

mkdir ~/zettelkastentouch ~/zettelkasten/neuron.dhall

At this point, I should be able to run neuron static page generator with autoreload on port 31337 (nothing specific, I just like the number):

--

--

Forketyfork
Forketyfork

Written by Forketyfork

Software developer @ JetBrains CodeCanvas. I write technical how-to articles and occasional rants on software development in general. Opinions are my own.

No responses yet