This story was originally published on HackerNoon at: https://hackernoon.com/asciidoc-when-markdown-just-isnt-cutting-it.
Markdown is amazing, but it has strong limitations. Asciidoc is the perfect tool to fill Markdown's gaps.
Check more stories related to tech-stories at: https://hackernoon.com/c/tech-stories. You can also check exclusive content about #asciidoc, #asciidoctor, #markdown, #documentation, #technical-writing, #markdown-alternative, #open-source-software, #hackernoon-top-story, and more.

This story was written by: @nfrankel. Learn more about this writer by checking @nfrankel's about page, and for more stories, please visit hackernoon.com.

Markdown is a lightweight markup language for creating formatted text using a plain-text editor. John Gruber created Markdown in 2004 as an easy-to-read markup language. Markdown is amazing, but it has strong limitations.