{"repo":"joakimmj/md-tangle","free":true,"listed":false,"github":"https://github.com/joakimmj/md-tangle","clone":"git clone https://github.com/joakimmj/md-tangle.git","description":"Generates (\"tangles\") source code from Markdown documents","language":"Python","stars":38,"topics":["configuration","configuration-management","markdown","python","literate-programming","markup"],"license":"MIT","category":"cli-tools","readme_excerpt":"[![app-badge]][PyPI-md-tangle] ![Version] ![License] ![Format] ![PyVer] ![Downloads] [md-tangle][PyPI-md-tangle] This project is a result of wanting config and setup files to be part of a document explaining my setup. I originally used [Org-mode][1] and [org-babel-tangle][2] in [Emacs][3] to achieve this. I really like Org-mode and Emacs, but I'm not fond of being dependent on one editor. This is the reason I wanted a [CLI][4], and a more widely used document [markup language][5]. This way of programming is called [literate programming][6]. This programming paradigm was introduced by Donald Knuth. The idea is to write a program as an explanation of the program logic in a natural language interspersed with snippets of traditional source code. The source code can then be generated (\"tangled\") by using some tool. As [Markdown][7] is used by most programmers, I saw that language fit for the task. Markdown is a plaintext-ish format popular with programmers. It's simple, easy and already has support for embedding code blocks using bash pip install md-tangle bash pip install -e . markdown Some title Describing the following code... bla bla. javascript tangle:helloWorld.js console.log(\"Hello, \"); console.log(\"world\"); Styling Adding header for my css files: css tangle:styles/button.css,styles/input.css / Styling for mye awesome app / By adding some css ... css tangle:styles/button.css button1 { border: none; } css tangle:styles/input.css button1 { border: none; } css tangle:styles/th","default_branch":null,"files":null,"tree":[],"storefront":"/r/joakimmj","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/joakimmj/md-tangle/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}