mdx - Execute your Markdown Code Blocks

Imagine you have the following Markdown file to document your commands:

# demo.md
## [simple_echo]() - Simple echo in shell

```sh
echo "hello world"
```

With mdx you execute the sh code block:

% mdx simple_echo
hello world

🚀 In a nutshell:

Pass arguments into your code block. ➔ Example
Define dependencies ➔ Example
supports shebangs in code block ➔ Example
parses all .md files in the CWD for potential commands
- list all commands using -list or -l

Getting started

You can simply download a binary which fits your operating system and achitecture from the releases page.

Then just use the demo.md from above to execute simple_echo.

Go should be installed on your system: Follow this guide to install go in your PATH.

$ git clone https://github.com/dim0x69/mdx
$ go build
$ go install

The idea for this project came from Makedown.