雲海Excel轉換Markdown表格工具

原由

Markdown是個挺好用的文檔寫做語言，有點有不少，學習成本低、很輕量、生成的文檔也很美觀、能很流暢的書寫。

固然缺點也是有的，其中一個缺點就是markdown語法畫表格實在太繁瑣了，不過因爲是純文本編輯也的確有這樣的限制。

最近在寫文檔時，涉及大量表格的編寫，想法是在Excel裏寫好，再使用工具轉成markdown格式。工具找到兩個：

• VS Code 的插件 Excel to Markdown table
• Exceltk

結果使用下來兩個都有缺陷，Excel to Markdown table 中文轉成了亂碼，Exceltk轉出來的markdown有多於拼音字母，懷疑是因爲拼音輸入法致使。

因爲上面問題想了想幹脆本身寫個工具吧（造個輪子）。

轉換工具

也就是 soc-excel-convert 項目 雲海Excel轉換，使用Python開發，基於 openpyxl 讀取Excel。

因爲是使用python3.7開發，所以應該只支持Python3+，等有空也把Python2.7支持上吧。

目前是 0.9.3 版本，支持轉換markdown表格，json暫時還不支持，其中對於文本中的特殊字符也會進行轉義，好比換行符、大於、小於等。

使用也很方便，首先使用 pip 安裝模塊:

pip install soc-excel-convert

簡單執行命令以下：

soc-excel-convert -e ./test/excel/demo1.xlsx

默認會在當前路徑下生成demo1目錄，以文件名命名，文件夾中會生成對應sheet的md文件，每一個sheet一個，以下圖：

其中文檔中的對齊策略以標題爲準（即Excel首行內容），文件內容以下:

|English|中文|左對齊|中間對齊|右對齊|數量|帶小數點數字|日期|超連接|換行|特殊字符|
|:--|:--|:--|:--:|--:|:--:|:--|:--|:--|:--|:--|
|show|怒髮衝冠，憑欄處、瀟瀟雨歇。|左對齊|中間對齊|右對齊|3|19001.123456789|2019-07-19&nbsp;12:12:11|從這裏點擊|從這裏<br />換行|特殊&gt;字符|
|me|擡望眼，仰天長嘯，壯懷激烈。|左對齊|中間對齊|右對齊|4|1902200001.12345|2019-07-20&nbsp;00:00:00|[這裏](https://github.com/treeyh)|這裏換<br />行|特殊&vert;字符|
|the|三十功名塵與土，八千里路雲和月。|左對齊|中間對齊|右對齊|5|1931231001.12345|2019-07-21&nbsp;00:00:00|從這裏打開|這裏換行<br />|特殊&lt;字符|
|money|莫等閒，白了少年頭，空悲切！|左對齊|中間對齊|右對齊|6|19001.123456789|2019-07-22&nbsp;00:00:00|[這裏](https://github.com/treeyh)|<br />這裏換行|特殊&amp;字符|

而後貼到對應的markdown文檔裏就好啦。

附上參數說明：

短參數名	長參數名	是否必傳	默認值	描述
-e	--excel	Y	None	指定須要轉換的excel文件路徑
-m	--mode	N	md	指定轉換格式, 可選參數: md(markdown)和json. <br />不傳默認爲md. 目前僅支持md;
-s	--sheets	N	''	指定輸出哪些sheet表格, 不傳輸出全部;
-t	--target	N	./{fileName}/	輸出目標路徑. 不傳默認當前目錄. <br />若是目錄不存在則會自動建立;

歡迎你們使用。

最後，感興趣點個star唄 ^-^ soc-excel-convert