Mdx – Execute Your Markdown Code Blocks, Now in Go

1. runme

   1 20 2,087 8.8 Go

   DevOps Notebooks Built with Markdown

   

   Great name ;)! Co-creator of https://github.com/stateful/runme here.

   We've expanded significantly onto the idea of a toy script/utility to bring multi-modality (editor, notebook, terminal, browser) with shared sessions to what's at the core, a universal task runner (see architecture link below).

   I'd love to chat about combining efforts if you love hacking on this. The same goes for the author of `mdx`.

   https://docs.runme.dev/resources/architecture

2. SaaSHub

   www.saashub.com featured

   SaaSHub - Software Alternatives and Reviews. SaaSHub helps you find the best software and product alternatives

   

3. mdx

   2 1 178 9.0 Go

   

   Hey HN!

   I recently came across makedown here on HN and loved the concept. Wanting to learn Go, I thought this could be a great starter project - so I started working on my own Go implementation, which I’m calling [mdx](https://github.com/dim0x69/mdx).

   Key Features:

   - Define dependencies between commands

4. makedown

   3 1 319 8.9 Python

   Organise your shell scripts within executable markdown files

   

   - Ability to pass arguments to code blocks

   Would love feedback and thoughts!

   Ref.[makedown](https://github.com/tzador/makedown) Thanks for the idea! :)

5. mdx

   4 115 19,564 6.4 JavaScript

   Markdown for the component era

   

   You might want to reconsider the name. MDX is already a well-known technology that combines markdown with JSX https://github.com/mdx-js/mdx/

6. runme

   5 3 5 5.1 Go

   Discontinued A quick hack for running commands from README.md files (by skx)

   

   I guess these kinda toy scripts/utilities get written a lot as they're not really super-common and there's no well-known standard.

   I wrote my own version too, a while back, because it seemed like it would be useful (and indeed it has been) - a golang tool to list/search/run named blocks from markdown, joining multiple blocks together if instructed to do so:

   https://github.com/skx/runme

7. md-tmpl

   6 1 9 3.3 Go

   Simple markdown templating using shell commands

   

8. baker

   7 5 11 9.3 Ruby

   Ruby CLI for project setup

   

   Similar in Ruby/shameless pluck:

   https://github.com/coezbek/baker

   I call this a Project-Setup-as-Code tool.

   Supports backticks for shell and triple backticks for executing Ruby code.

   If blocks are successfully executed they are marked as done (using markdown [x] checkboxes). So you can incrementally run a file without executing stuff twice.

9. marko

   8 47 14,371 9.7 JavaScript

   A declarative, HTML-based language that makes building web apps fun

   

10. simpatico

    9 3 8 8.7 JavaScript

    Discontinued Simpatico is an umbrella term for several data-structures and algorithms written in JavaScript

    I wrote something similar, but for the web. I call it "Literate Markdown" (https://simpatico.io/lit.md) and you write markdown and your html/css/js/md code blocks are both exposed as text and as code blocks for execution in the browser. The format expects to a) be transformed and exposed by a special server (https://simpatico.io/reflector.md) and b) rendered in a browser. This code also includes a simple test harness that, for example, turns the favicon green/red depending on if exceptions are thrown in your code (https://simpatico.io/testable.js)

    Sadly I haven't taken the time to make the repo (https://github.com/javajosh/simpatico/) npm/npx compatible so you have to fork and run, rather than npm/npx install. Speaking of which this is a local first, minimalist project that has like 2 small dependencies, which themselves have no deps.

    Some other nicities include a complete list of scripts I use to prepare a public VPS to run the server, including certbot management. https://github.com/javajosh/simpatico/tree/master/devops.

    Eventually I'd like an automatic md-> js process, such that the md is the canonical source for javascript and the final js is a build product. I'd also like to clean up the code and publish to npm, but sadly someone is squatting on the @simpatico handle and npm won't do anything. :(

11. rundown

    10 1 8 4.1 Go

    Rundown runs Markdown files, making them powerful and pretty console applications

    

    cf. rundown https://github.com/elseano/rundown

12. mdsh

    11 5 201 0.0 Shell

    Multi-lingual, Markdown-based Literate Programming... in run-anywhere bash

    

13. rmarkdown

    12 44 3,039 6.8 R

    Dynamic Documents for R

    

    reminds me a lot of rmarkdown - which allows you to run many languages in a similar fashion https://rmarkdown.rstudio.com/

14. org-babel

    13 1 8 - Emacs Lisp

    org-mode code evaluation with a focus on data transfer, and exportation

    

    https://github.com/taruti/org-babel/tree/master

    I don't think it ever had huge adoption across whole teams, but I hope if there are new implementations that they take away a number of lessons you can gather from 15 years of org-babel.

15. codebook-md

    14 1 8 9.2 TypeScript

    Bring your markdown to life with this VS Code extension. Execute code blocks at the click of a button in a notebook style similar to Jupyter. GitHub permalinks will show a preview and can be clicked to navigate to the file/line locally.

    

    I started in on a similar project a few months ago when I was going through a short "burn out" phase, haha.

    https://github.com/josephbergevin/codebook-md

    Have a look, I'd love to get some feedback. For me, it's in a good enough state that I'm able to use it in my everyday coding - but it definitely has a lot of room for improvement.

Suggest a related project