更新針對非技術人員的小白教學:
【上篇:基本原理】 《懶人福音: 怎麼做一個從不排版的微信小編? 》
【下篇:文法指南】 《微信公眾號MarkDown排版完全指南》
下載最新穩定版本:Windows版/Mac版
.md
文件,放入temp
目錄。maxpress
程序, result/html
目錄下將產生同名的.html
檔。.html
文件,全選複製,貼上到微信編輯器。【注意事項】
.md
檔案、多個子目錄(包括巢狀子目錄)的批次轉換。.md
檔案移至result/archive
目錄下,可修改設定檔(auto_archive)停用此功能。在執行轉換程式之前,修改config.json
文件,可自訂常用格式變數。
包括:
變數名 | 預設值 | 說明 |
---|---|---|
main_size | 16px | 正文主字號 |
theme_color | #349971 | 主題色,用於標題、強調元素等文字顏色 |
text_color | #555 | 正文文字顏色 |
quote_color | #999 | 引用框和程式碼框內文字顏色 |
line_height | 2em | 正文行高 |
para_spacing | 1.5em | 正文段間距 |
align | 多項 | 各部分的水平對齊方式,建議left 或center ( h1 ~ h6 代表標題1~標題6, content 代表正文) |
main_margin | 3% | 內容兩側留白比例 |
banner_url | "" | 文章頭部引導注意圖片的url |
poster_url | "" | 底部二維碼/海報圖片的網址 |
convert_list | true | 將正文中的清單轉換為普通段落,以修正微信無法正常顯示清單序號樣式的問題(僅用於微信) |
ul_style | "○" | 將無序列表轉換為普通段落後,每項先前的符號識別(僅當convert_list 為true 時啟用) |
auto_archive | "" | 是否自動存檔(轉換後將原始.md 檔案移至result/archive 目錄下) |
auto_rename | false | 衝突檔案名稱的處理: true 自動重命名; false 覆蓋先前的文件 |
備註:
theme_color
,其餘可以採用預設配置。convert_list
選項新增為臨時解決方案,當此項為true
時,正文中的所有清單(不包含程式碼區塊中的內容)會轉換為段首帶序號的普通段落。注意,在這種情況下, styles.less
中專門為清單設定的樣式將會失效。如果你有更好的辦法,歡迎開issue告訴我。 如果你希望覆寫預設樣式中的個別樣式,可以自主編寫custom.css
,它將在default.css
之後被引入。
example.md
-> example.html
(html請下載後在瀏覽器中開啟)
公眾號文章範例:微信公眾號MarkDown排版完全指南
如果你的電腦上裝有Python環境,可以直接執行腳本。建議從Master分支取得最新穩定版本。
使用Python 3.5.2開發,CSS樣式表使用LESS編譯。建議在Python 3環境下使用。
依賴的套件:mistune, premailer, lesscpy
快速安裝依賴: pip install -r requirements.txt
直接運行: python maxpress.py
或作為模組導入:
import maxpress
maxpress.convert_all(archive=True, styles=None)
如果你希望整體棄用預設樣式並啟用自訂CSS樣式表,可以透過styles
參數傳入自訂CSS檔案路徑(支援用列表傳入多個),這時config.json
中用於定義樣式的參數將會失效, custom.css
將在你的全部自訂樣式表之後引入。
當有樣式的清單貼到微信編輯器時,可能意外出現格式遺失的情況(貌似是微信的bug?),目前透過在每個li
元素內額外添加一個span
元素包裝樣式,暫時可以解決。但要注意,如果自訂樣式的話,為li span
所設定的字號、顏色等不能與上級元素完全一致,否則在貼到微信編輯器時會被自動去掉。
example.md
-> example.html
(html請下載後在瀏覽器中開啟)
設計思路及部分預設樣式參考了:
markdownhere.css
MIT