Notion app logo
Struggling to stay organized and effective? Learn to master your time and tasks with the Effectively Notion course!

Tangling Markdown (Literate Programming)

How to tangle markdown in literate programming with a Python executable.


I want to experiment with tangling my Markdown files into code and configuration files.


I'm experimenting with the md-tangle Python project.

Setup md-tangle

First, I made sure I had pip installed, by installing pip with Homebrew.

Next, I installed md-tangle with pip:

 python3 -m pip install md-tangle

Next, I verified that md-tangle is in my PATH by running which md-tangle in the Terminal. If this was successful, it will show me a path to md-tangle.


Now that I have md-tangle installed, I can create a new Markdown file in Obsidian.

I'll create a directory in my vault called 42 - Dotfiles, where all of my dotfile Markdown source will live. In that directory, I'll create my first file for my custom Obsidian CSS snippets, called Obsidian Styles.

Once I've done that, I start writing out my documentation for my styles. I write the documentation and then I write a code snippet in a code fence.

Photo of Chase Adams

Hey, I'm Chase. I help aspiring entrepreneurs and makers turn their ideas into digital products and apps.


Vector Arrow Scribbles
banner image for figma vector arrows scribbles

A figma community project of vectorized hand-drawn arrows.

Go To Figma
Vector Line Scribbles
banner for figma vector line scribbles

A figma community project of vectorized hand-drawn lines.

Go To Figma
Vector Shape Scribbles
banner image of figma vector shapes scribbles

A figma community project of vectorized hand-drawn shapes.

Go To Figma

Subscribe to my Newsletter

Every other week I publish the Curiously Crafted newsletter.

In it, I explore the intersection of curiosity and craft: the people who make stuff, what they make and the way they pursue the craft of making.


I'm on almost all social media as @curiouslychase.

The curious logo of Chase Adams: glasses and a bow tie.stay curious.