markdown_exec
rundoc
markdown_exec | rundoc | |
---|---|---|
5 | 3 | |
10 | 57 | |
- | - | |
8.3 | 2.1 | |
6 days ago | 5 days ago | |
Ruby | Ruby | |
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.
markdown_exec
-
Script to setup all dev tools in a local environment
If you go down the route of using Ansible, this is a very complete tool for Mac OS. Even if you don't use it, you can see how many useful apps can be installed mac-dev-playbook And if Ansible if just too much, try this simple way to code, document, and replay bits of your installation scripts with this tool I wrote recently and use to deploy systems daily. markdown_exec
- A command-line tool (Ruby gem) to interactively select and execute code blocks in markdown files. Build complex shell scripts by naming and requiring blocks. Log resulting scripts and output. Multi-stage tab completion to make use on the command line easy!
- A command-line tool (Ruby gem) to interactively select and execute code blocks in markdown files. Build complex scripts by naming and requiring blocks. Log resulting scripts and output. Re-run scripts. Multi-stage tab completion to make use on the command line easy!
- A command-line gem to interactively select and execute code blocks in markdown files
- A command-line tool (Ruby gem) to interactively select and execute code blocks in markdown files
rundoc
-
Documentation as code: Principles, workflow, and challenges
I wrote a custom tool that “runs” tutorials and embeds the output of commands in the resulting doc. It also acts as a test as each command run is checked for non-zero exit.
It supports some neat features like webpage manipulation and screenshots. Check it out https://github.com/zombocom/rundoc
-
Docs Deserve More Respect
I wrote a book with a chapter on how to write docs for other people’s code https://howtoopensource.dev
I also wrote an open source tool for writing and testing tutorials https://github.com/zombocom/rundoc and another that will email you undocumented methods of open source code so you can practice writing documentation https://www.codetriage.com/.
- A command-line gem to interactively select and execute code blocks in markdown files
What are some alternatives?
CommonMarker - Ruby wrapper for the comrak (CommonMark parser) Rust crate
Maruku - A pure-Ruby Markdown-superset interpreter (Official Repo).
reverse_markdown - Ruby gem to convert html into markdown
word-to-markdown - A ruby gem to liberate content from Microsoft Word documents
kramdown - kramdown is a fast, pure Ruby Markdown superset converter, using a strict syntax definition and supporting several common extensions.
Tocer - A command line interface for generating Markdown table of contents.
Redcarpet - The safe Markdown parser, reloaded.
github-orgmode-tests - This is a test project where you can explore how github interprets Org-mode files
mac-dev-playbook - Mac setup and configuration via Ansible.
local-development-setup