將文件 md 轉成 ad

Markdown asciidoc markdown - 2022-06-15

kramdoc <yourfile>.md

Why

有太多 markdown ，但你決定之後只寫 asciidoc。不想從頭寫一遍。這時候你需要 kramdown。

Maruku: maruku 一個用 Ruby 寫的 Markdown 解釋器。
kramdown: kramdown 一個用 Ruby 寫的，用於解析和轉換 Markdown 的工具。支持標準 Markdown 和各種 PHP Markdown Extra 和 Maruku 擴展。可以替代用來 Maruku。
kramdoc: kramdoc kramdown 的擴展，轉換 Markdown 文件到 AsciiDoc 文件的工具。

安裝 Ruby。

安裝 kramdown 和 kramdoc。

> gem install kramdown
> gem install kramdown-asciidoc

> kramdoc --format=GFM \  // (1)
          --output=<yourfile>.ad \
          --wrap=ventilate \
          <yourfile>.md

--format 支援 GFM|kramdown|markdown，內定是 GFM。

kramdoc <yourfile>.md。

內定附檔名會改為 .adoc。