用 Pandoc 取代 Typora,將 Markdown 轉換成 HTML (without styles) 檔

pandoc typora



之前升級系統的時候,意外發現 Typora 正式版已經變成收費軟體了。而流浪貓因為長時間使用舊版 (0.11) 的關係,一直沒注意到這點。畢竟 Linux 是出了名的穩定,只要系統沒太大變動,通常能長時間維持驚人的穩定度,直到重建工作環境時才發現這個有趣的問題。


雖然 Typora 是站長最喜歡的 Markdown 編輯軟體,但比起喜歡某個軟體,流浪貓更喜歡自由自在、不受拘束的感覺。因此我目前不打算付錢、也不想研究破解方法,而是趁這個機會思考使用它的初衷與其替代方案。


Typora 的優點

站長會用 Typora 來工作,主要是因為看上它的表格複製能力。當年我測試過多款 Markdown 編輯器後,發現 Typora 是少數能完美轉換網頁表格的軟體。其餘的不是格式亂掉、錯位,就是複製到多餘的欄位,真不曉得開發者是用了什麼黑科技才達到這樣的成果。


Typora - 收集、整理網頁圖片、表格資料與筆記


另一方面,Typora 也是少數幾款能輸出純 HTML 檔,且不會產生多餘的 CSS, style 程式碼的編輯器。


用 Markdown 進行跨平台文章發表與備份的方法


其實光是這兩個特點,就相當值得使用者掏錢出來朝聖了。無奈流浪貓很窮,且文書編輯軟體的付費誘因對我而言實在不夠大,因此只能忍痛尋找其他替代方案。



用 Pandoc 作為替代方案

仔細考量目前的狀況後,我意識到複製表格資料已經不是我最迫切的目標,反而是『輸出純 HTML 檔案』更為重要。因此 pandoc 這款能轉換不同標記語言的工具,就相當符合我的需求。


安裝和使用 pandoc 的方法:

sudo apt install pandoc
pandoc -f markdown -t html in.md -o out.html


不過,代誌沒有笨貓想的這麼簡單。因為 md 轉換成 HTML 之後,圖片的 alt 替代文字不但會消失,還會自己跑到外面變成獨立的段落。


![替代文字](網址)

<figure>
<img src="圖片網址" alt="" />
<figcaption aria-hidden="true">替代文字</figcaption>
</figure>


解決的方法也很簡單,根據官方的發行紀錄可得知,這個問題是舊版的 Bug,只要更新到 Pandoc 3.1.5 即可解決。習習翠維尼


不過事情還沒結束,因為 figure 和 figcaption 這兩項圖片區塊元素在 Blogger 環境派不上用場,是相當累贅的存在。


對於這個問題,我們可以加入 -fmarkdown-implicit_figures 參數,讓 pandoc 輸出時忽略掉這個標籤。


pandoc -f markdown -t html in.md -o out.html -fmarkdown-implicit_figures


如此一來,就能獲得最純的 HTML 檔了。




d(´∀`)b



延伸閱讀

Obsidian 善用標籤,打造更透徹的筆記關聯圖

用 Markdown 進行跨平台文章發表與備份的方法

Typora - 收集、整理網頁圖片、表格資料與筆記

更多 Obsidian 教學

更多 Markdown 文章

關於 Blogger 的教學

留言

這個網誌中的熱門文章