<< Previous | Next >>

Daily Learnings: Wed, Feb 07, 2024

Experience is not what happens to you; it’s what you do with what happens to you. — Aldous Huxley

Notes on Remark

For my personal site, I did some study on remark, the popular tool for processing and transforming Markdown text. I’m currently trying to add to my site’s build pipeline the automatic generation of backlinks for all of my public files. I started out by searching for any open-source libraries that could do this for me, and I found a promising library to called note-link-janitor (found here).

Unfortunately, the library is a bit out-of-date, and I also wanted to adjust some of the default functionality. I forked the repo and started updating the dependencies, and tweaking the behavior. However, when I dove into the code, I quickly realized that I was out of my depth, especially since I’m not as familiar with remark and its ecosystem.

After updating all of the dependencies, installing some of my preferred tooling (like prettier and eslint), and getting all of the Typescript errors squashed, I decided that the best path forward was to take a bit of a dive into the remark ecosystem and its related plugins.

I wrote more about what I learned in a longer-form post found here. It started as a general note, but quickly grew to be larger. So I decided to make it a full post instead. tbh I’m still trying to figure out the delineation between my notes content vs. blog posts, especially when notes end up getting longer…

References