[Transparency: I build this stuff.]

With gem markdown_helper, you can:

• Use file inclusion to keep your documentation DRY (Don't Repeat Yourself).

• Include dynamically generated text. In particular, you can keep your examples "green" by continuously re-running and re-including them.

• Nest file inclusions.

• Include text as:

  • Markdown.
  • Code block.
  • Highlighted code block.
  • Pre-formatted text.
  • Markdown comment.

• Include an automatically-generated page TOC (table of contents).

• Use either interface:

  • CLI (no Ruby coding needed).
  • API in your Ruby code.