Entangled: Literate Programming in Markdown
(entangled.github.io)
from HaraldvonBlauzahn@feddit.org to programming@programming.dev on 21 Jun 05:34
https://feddit.org/post/14538912
from HaraldvonBlauzahn@feddit.org to programming@programming.dev on 21 Jun 05:34
https://feddit.org/post/14538912
Perhaps the most powerful and widely used tool for literate programming ist Emacs org-mode with the babel extension. I have used it, and it is good!
However, org-mode puts a hurdle to novice users - to practice literate programming, they need to learn a bit of Emacs, which is a task in itself.
I linked the above project because it has two interesting properties:
-
One can write the literate document in Markdown. This is not as powerful as org-mode, which is tailored to larger documents, but very accessible.
-
One can modify the generated source files directly, and they are automatically read back into the literate document. This makes it much easier to work with existing tools that modify source code.
threaded - newest
I’ve used rmarkdown back when i was in academia, having dabbled in jupyter years before. I think the main issue with literate programming is knowing your target audience. people differ wildly in their tech skills, and i guess that those people who use literate programming to its potential are the same who are happy to use org-mode.
others just copy paste their analysis scripts they cobbled together into whatever interface and copy the result into word and start formatting.
just a thought