Mdx – Execute Your Markdown Code Blocks, Now in Go

1. runme

   1 17 1,470 9.1 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. InfluxDB

   www.influxdata.com featured

   InfluxDB – Built for High-Performance Time Series Workloads. InfluxDB 3 OSS is now GA. Transform, enrich, and act on time series data directly in the database. Automate critical tasks and eliminate the need to move data externally. Download now.

   

3. mdx

   2 1 176 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 311 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 108 18,595 7.8 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 2 5 5.1 Go

   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 6 - Go

   Simple markdown templating using shell commands

   

8. baker

   7 4 6 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. Stream

   getstream.io featured

   Stream - Scalable APIs for Chat, Feeds, Moderation, & Video. Stream helps developers build engaging apps that scale to millions with performant and flexible Chat, Feeds, Moderation, and Video APIs and SDKs powered by a global edge network and enterprise-grade infrastructure.

   

10. marko

    8 43 13,635 9.8 JavaScript

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

    

11. 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. :(

12. rundown

    10 1 7 4.1 Go

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

    

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

13. mdsh

    11 5 190 0.0 Shell

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

    

14. rmarkdown

    12 41 2,949 6.0 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/

15. 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.

16. codebook-md

    14 1 7 9.6 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.

17. SaaSHub

    www.saashub.com featured

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

    

Suggest a related project