executable markdonw files

midgy runs markdown documents as python .

🤔 imagine being able to run your README.md as code. you could run the following command

midgy README.md

and all your is converted to valid , and off your go!

🔮 the future is markdown

markdown has emerged is a common file format for documentutation. those just learning programming will bring rely on their language to read and write code. midgys approach to literate programming leaves space for both natural and programming languages to cooperate in a story. it brings flexibility and freedom to the composition of news ideas.¹

ℹ️ about this documentation

this documentation describes:

• the midgy language specification describes how markdown is translated to python
• the midgy implementation describes the specifics of the python implementation.²
• the midgy design describes the design constraints this work was developed under.

---

1. freedom is a feature of literate programming more generally. in different literate programming circles like orgmode, rmarkdown, quarto, jupyter we notice a common thread of joy in composing programs. we find these features are by design when we reference the original literate programming paper: ↩

2. this specific implementation is written in python, but there is a little holding others back from porting this to other languages. ↩