Markdown Bash Execute

markdown-bash-execute.md

Markdown Bash Execute

• Execute bash code block from a markdown file → ```bash [...] ```

Getting started

• add this to your .bashrc or .zshrc or .what-ever.rc

# markdown bash execute
function mbe() {
  if [ -f "$1" ]; then
    cat $1 | # print the file
    sed -n '/```bash/,/```/p' | # get the bash code blocks
    sed 's/```bash//g' | #  remove the ```bash
    sed 's/```//g' | # remove the trailing ```
    sed '/^$/d' | # remove empty lines
    /usr/bin/env sh ; # execute the command
  else
    echo "${1} is not valid" ;
  fi
}

• call with mbe file.md

• Enjoy !

Could you provide a quick example please ?

Here is a little hack I made up, it uses heredocs and replaces codeblocks with the output:

#! /usr/bin/dash
#md-sh:

dash << end_sh
$1 << end_md
$(cat $2)
end_md
end_sh

Here is an example on how to use:

md-sh cat doc.md

or to format the output:

md-sh mdcat doc.md

Should have searched before writing my own!

If anyone needs multiple language / block support, I ended up doing something slightly more involved with python: