2013年9月30日

使用 Pandoc 自動轉檔 Markdown to BBCode (for iT邦幫忙鐵人賽)

Markdown 是網路時代寫作的必學格式,它的目標是「易讀易寫」,請參考 Markdown 語法說明

在 Mac OS X 系統,Mou 是相當 Nice 的 Markdown 專用編輯器,對文件寫作效率頗有幫助。


用 Markdown 寫文件的好處,除了容易讀與寫,還有一個非常大的功用,就是容易搭配工具轉換成其他格式。

Pandoc 為例,可以轉成 HTML:

  • pandoc -t html document.md

也能打包成 ePub 格式:

  • pandoc -t epub document.md -o document.epub


還可以轉成 PDF 發佈:

  • pandoc --template=default.latex --latex-engine=xelatex -V fontsize=13pt document.md -o document.pdf
(PDF 中文排版請參考專用的 default.latex 定義檔。)

對於參加「iT邦幫忙鐵人賽」的寫作者,還可以自動轉出 BBCode 格式。

雖然 Pandoc 並未內建 BBCode writer support,但是新版的 Pandoc 支援以 Lua 語言擴充 Writer 定義。

這個指令範例,順便用 pbcopy(Mac OS X only) 將轉換結果複製到剪貼簿,方便直接貼到 iT邦幫忙 的線上編輯器。
  • pandoc -t ithelp.lua document.md | pbcopy

(Lua Script 的範例請參考 ithelp.lua 範本。)

iT 邦幫忙並未支援所有 BBCode 常見語法,所以必須部分語法需要客製處理,目前 ithelp.lua 還在持續發展中,歡迎有興趣的朋友交流討論。

轉換結果請參考我的鐵人賽貼文


沒有留言:

張貼留言

lyhcode by lyhcode
歡迎轉載,請務必註明出處!