Skip to content
forked from qfwc258/maxpress

MaxPress:MarkDown+Python实现微信公众号一键排版

License

Notifications You must be signed in to change notification settings

tjmc6888/maxpress

 
 

Repository files navigation

MaxPress:MarkDown+Python实现微信公众号一键排版

基本功能

  1. 批量转换MarkDown文档为适合粘贴微信编辑器的HTML文件。
  2. 支持自定义:正文字号、文字颜色(正文颜色、主题色、引用色)、行间距、段间距、标题水平对齐方式、内容两侧留白比例、底部图片。
  3. 转换完成的MarkDown文档可以自动移动存档。

开始使用

下载

下载最新稳定版本:Windows版/Mac版

使用Windows/Mac版可执行程序

一键排版

  1. 使用Markdown创作你的内容,保存为.md文件,放入temp目录中。
  2. 双击运行maxpress程序,result/html目录下将生成同名的.html文件。
  3. 用浏览器打开生成的.html文件,全选复制,粘贴到微信编辑器中。
  4. 检查,预览,调整。

【注意事项】

  1. 推送前请务必发送到手机预览仔细检查,作者不为最终样式的绝对正确担保。
  2. 转换前请务必在软件目录之外留有原文档副本,作者不为意外发生的数据丢失负责。
  3. 目前只测试了Win/Mac上的Chrome浏览器,如果这一步出现格式丢失/错乱等情况,请在issue中反馈,说明你遇到的问题、使用的系统和浏览器。
  4. 支持多个.md文件、多个子目录(包括嵌套子目录)的批量转换。
  5. 默认进行自动存档,即转换完毕后将所有原始.md文件移动至result/archive目录下,可修改配置文件(auto_archive)禁用此功能。
  6. 如果出现文件名冲突的情况,默认同文件名自动覆盖,可修改配置文件(auto_rename)改为进行自动重命名。

格式调整

在运行转换程序之前,修改config.json文件,可自定义常用格式变量。

包括:

变量名 默认值 说明
main_size 16px 正文主字号
theme_color #02ccba 主题色,用于标题、强调元素等文字颜色
text_color #555 正文文字颜色
quote_color #999 引用框和代码框内文字颜色
line_height 2em 正文行高
para_spacing 1.5em 正文段间距
title_align left 标题水平对齐方式,建议leftcenter(仅支持h3-h6,h1、h2固定使用左对齐)
main_margin 3% 内容两侧留白比例
poster_url "" 底部二维码/海报图片的地址
auto_archive "" 是否自动存档(转换后将原始.md文件移动至result/archive目录下)
auto_rename false 冲突文件名的处理:true自动重命名;false覆盖先前的文件

更多自定义

如果你希望覆盖默认样式中的个别样式,可以自主编写custom.css,它将在default.css之后被引入。

示例

example.md -> example.html (html请下载后在浏览器中打开)

公众号文章示例:MarkDown微信排版说明及示例

使用Python脚本【推荐】

如果你的计算机上装有Python环境,可以直接运行脚本。建议从Master分支获取最新稳定版本。

开发环境

使用Python 3.5.2开发,CSS样式表使用LESS编译。建议在Python 3环境下使用。

依赖的包:mistunepremailerlesscpy

快速安装依赖: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请下载后在浏览器中打开)

后续开发计划

  • 可选在文首自动添加引导关注Banner
  • 代码的精简&重构(不影响功能)
  • 支持更多样化的文中小标题模式配置
  • 支持Hexo博客文章的直接转换
  • 简化HTML及CSS自定义流程

Reference

设计思路及部分默认样式参考了:

License

MIT

About

MaxPress:MarkDown+Python实现微信公众号一键排版

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%