mexdown
runbook
Our great sponsors
| mexdown | runbook | |
|---|---|---|
| 2 | 3 | |
| 13 | 32 | |
| - | - | |
| 10.0 | 0.0 | |
| about 4 years ago | almost 2 years ago | |
| Go | TypeScript | |
| MIT License | MIT License |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
mexdown
-
Include diagrams in your Markdown files with Mermaid
I like this approach of using the tag associated with a code block to determine how to render the output. It's the same approach I take in my markdown-derived markup language: https://github.com/smasher164/mexdown.
The top example there takes a GraphViz description and passes it into the dot command, placing the resultant SVG into the HTML output.
-
Show HN: JWEB (a modern implementation of the CWEB Literate Programming system)
This is similar to the approach I take in my markup language: https://github.com/smasher164/mexdown. Pipe the body of a code block to the command's stdin, and replace the code block with its output.
runbook
-
Literate DevOps
Also check out https://github.com/khalidx/runbook (shameless plug). Executable markdown documents that you can run. Great for DevOps and sharing commands with the team.
- Pryrite: Interactively execute shell code blocks in a Markdown file
-
Show HN: JWEB (a modern implementation of the CWEB Literate Programming system)
Interesting, going to check this out today.
I built something in a similar spirit to your comment and this larger thread, albeit a bit simplistic. Lets you document and write your bash scripts in a markdown file, then you can run the blocks. It figures out what arguments you expect in a block and turns them into CLI flags. https://github.com/khalidx/runbook
Not sure how useful it is but I use it to maintain a collection of documented bash scripts.
What are some alternatives?
Mermaid - Edit, preview and share mermaid charts/diagrams. New implementation of the live editor.
nbterm - Jupyter Notebooks in the terminal.
aasvg - Turn ASCII art into SVG
pryrite - Pryrite, interactively execute shell code blocks in a markdown file
markup - Determines which markup library to use to render a content file (e.g. README) on GitHub
jweb - The JWEB system of Literate Programming
RawParser - Showing how a grammar driven parser can be implemented
asciitosvg - Create beautiful SVG renderings of ASCII diagrams.