While doing so, also explore the possibility of parsing .md files only once (see #762 for more context)
In cases where complexity cannot be avoided, make sure to add comments to the relevant components/functions and document any unintuitive behaviour. (Related to #602)