md2wx-cli 0.2.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (30) hide show
  1. md2wx_cli-0.2.0/LICENSE +21 -0
  2. md2wx_cli-0.2.0/PKG-INFO +184 -0
  3. md2wx_cli-0.2.0/README.md +169 -0
  4. md2wx_cli-0.2.0/pyproject.toml +29 -0
  5. md2wx_cli-0.2.0/setup.cfg +4 -0
  6. md2wx_cli-0.2.0/src/md2wx/__init__.py +3 -0
  7. md2wx_cli-0.2.0/src/md2wx/cli.py +299 -0
  8. md2wx_cli-0.2.0/src/md2wx/clipboard.py +169 -0
  9. md2wx_cli-0.2.0/src/md2wx/config.py +83 -0
  10. md2wx_cli-0.2.0/src/md2wx/containers.py +177 -0
  11. md2wx_cli-0.2.0/src/md2wx/converter.py +206 -0
  12. md2wx_cli-0.2.0/src/md2wx/fetcher.py +211 -0
  13. md2wx_cli-0.2.0/src/md2wx/gallery.py +199 -0
  14. md2wx_cli-0.2.0/src/md2wx/publisher.py +136 -0
  15. md2wx_cli-0.2.0/src/md2wx/styler.py +288 -0
  16. md2wx_cli-0.2.0/src/md2wx/theme.py +117 -0
  17. md2wx_cli-0.2.0/src/md2wx/theme_extractor.py +295 -0
  18. md2wx_cli-0.2.0/src/md2wx/themes/bauhaus.yaml +207 -0
  19. md2wx_cli-0.2.0/src/md2wx/themes/bold-green.yaml +198 -0
  20. md2wx_cli-0.2.0/src/md2wx/themes/bold-navy.yaml +197 -0
  21. md2wx_cli-0.2.0/src/md2wx/themes/default.yaml +217 -0
  22. md2wx_cli-0.2.0/src/md2wx/themes/github-tech.yaml +104 -0
  23. md2wx_cli-0.2.0/src/md2wx/validator.py +166 -0
  24. md2wx_cli-0.2.0/src/md2wx/wechat_api.py +141 -0
  25. md2wx_cli-0.2.0/src/md2wx_cli.egg-info/PKG-INFO +184 -0
  26. md2wx_cli-0.2.0/src/md2wx_cli.egg-info/SOURCES.txt +28 -0
  27. md2wx_cli-0.2.0/src/md2wx_cli.egg-info/dependency_links.txt +1 -0
  28. md2wx_cli-0.2.0/src/md2wx_cli.egg-info/entry_points.txt +2 -0
  29. md2wx_cli-0.2.0/src/md2wx_cli.egg-info/requires.txt +5 -0
  30. md2wx_cli-0.2.0/src/md2wx_cli.egg-info/top_level.txt +1 -0
md2wx_cli-0.2.0/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 md2wx Contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
md2wx_cli-0.2.0/PKG-INFO ADDED
@@ -0,0 +1,184 @@
1
+ Metadata-Version: 2.4
2
+ Name: md2wx-cli
3
+ Version: 0.2.0
4
+ Summary: 轻量级 Markdown 转微信公众号 HTML CLI 工具（支持剪贴板直达、主题提取、WeChatSync 联动）
5
+ License-Expression: MIT
6
+ Requires-Python: >=3.11
7
+ Description-Content-Type: text/markdown
8
+ License-File: LICENSE
9
+ Requires-Dist: markdown>=3.10
10
+ Requires-Dist: beautifulsoup4>=4.14
11
+ Requires-Dist: cssutils>=2.11
12
+ Requires-Dist: pyyaml>=6.0
13
+ Requires-Dist: Pygments>=2.17
14
+ Dynamic: license-file
15
+
16
+ # md2wx
17
+
18
+ > 🚀 **轻量、确定性、高保真度的 Markdown 转微信公众号排版 CLI 工具**。
19
+ >
20
+ > 深度支持全内联 CSS 注入、5 大精选排版主题、多主题画廊一键对比、微信推文一键抓取逆向、主题智能提取、公众号官方 API 直传草稿箱与排版体检诊断。
21
+
22
+ ---
23
+
24
+ ## ✨ 核心特性
25
+
26
+ - 🎨 **极简现代排版与精选主题栈**：
27
+ - **`default`（默认）**：现代极简杂志编辑风（Noto Serif 宋体衬线大标题、Slate-600 通透正文、曜石黑字重层次、居中浅蓝高亮胶囊、实心品牌色横幅与图片弥散阴影）。
28
+ - **`github-tech`**：经典 GitHub 开发者科技风（深炭黑标题、底边细分割线、OneDark 代码高亮）。
29
+ - **`bauhaus`**：包豪斯艺术几何设计风。
30
+ - **`bold-green`**：清新高对比度科技绿。
31
+ - **`bold-navy`**：深邃藏青商务编辑风。
32
+ - 🖼️ **多主题交互式对比画廊 (`gallery`)**：一键生成全主题交互式 HTML 预览画廊，直接在浏览器中秒级切换对比排版效果。
33
+ - 📥 **微信推文一键抓取与逆向 (`fetch`)**：输入任意微信公众号文章 URL，自动下载全部配图并逆向转换为纯净 Markdown，自动识别居中高亮卡片、白底项目卡片与实心横幅。
34
+ - 🪄 **主题深度逆向提取 (`learn-theme`)**：支持从本地目录、HTML 文件或推文 URL 自动提取双字体栈、标题边框、加粗字重、Callout 风格与图片阴影，缺失组件由 `github-tech` 安全兜底。
35
+ - 🚀 **原生官方 API 直传微信草稿箱 (`-p / --publish`)**：直接集成微信公众平台官方接口，自动将本地配图上传至微信永久素材图床，一键推送到公众号草稿箱（支持 `~/.md2wx/config.yaml` 免密保存）。
36
+ - 📋 **系统剪贴板一键直达 (`-c`)**：直接将富文本 HTML 写入系统剪贴板（含 Windows `CF_HTML` 协议与 `span[leaf]` 防样式丢失保护），进入微信公众号编辑器 `Ctrl+V` 即可完美粘贴。
37
+ - 🩺 **微信排版兼容性与合规体检 (`check`)**：内置 16+ 条微信富文本平台硬规则检测（拦截非法 CSS、缺失图片、未脚注外链等）。
38
+
39
+ ---
40
+
41
+ ## 📦 快速安装与即用
42
+
43
+ ### 1. 免安装即用（推荐）
44
+ ```bash
45
+ uvx md2wx article.md -c
46
+ ```
47
+
48
+ ### 2. 全局标准安装
49
+ ```bash
50
+ pip install md2wx
51
+ ```
52
+
53
+ ### 3. 本地源码安装
54
+ ```bash
55
+ git clone https://github.com/your-name/md2wx.git
56
+ cd md2wx
57
+ pip install -e .
58
+ ```
59
+
60
+ ---
61
+
62
+ ## 📖 核心命令与用法
63
+
64
+ ### 1. 基础转换与排版
65
+ ```bash
66
+ # 转换 Markdown 为微信 HTML 片段并直接复制到系统剪贴板（默认使用 default 杂志风）
67
+ md2wx article.md -c
68
+
69
+ # 输出为 HTML 文件
70
+ md2wx article.md -o output.html
71
+
72
+ # 指定精选主题（如 github-tech）
73
+ md2wx article.md -t github-tech -c
74
+
75
+ # 生成包含完整 <html> 骨架的独立全页面（适合本地双击预览）
76
+ md2wx article.md -o preview.html --full-page
77
+
78
+ # 支持标准输入管道
79
+ cat article.md | md2wx -c
80
+ ```
81
+
82
+ ---
83
+
84
+ ### 2. 多主题交互式画廊对比 (`gallery`)
85
+ ```bash
86
+ # 一键生成全主题交互式对比页面并在默认浏览器打开
87
+ md2wx gallery article.md -o gallery.html --open
88
+ ```
89
+
90
+ ---
91
+
92
+ ### 3. 抓取微信推文并逆向为 Markdown (`fetch`)
93
+ ```bash
94
+ # 从微信推文在线 URL 抓取正文与图片，生成高质量 Markdown
95
+ md2wx fetch "https://mp.weixin.qq.com/s/xxxxxx" -o "article.md"
96
+ ```
97
+
98
+ ---
99
+
100
+ ### 4. 学习与逆向提取主题 (`learn-theme`)
101
+ ```bash
102
+ # 从本地设计快照目录提取主题并保存
103
+ md2wx learn-theme --dir ./my_design_folder -n "my-custom-theme"
104
+
105
+ # 从单个 HTML 文件提取主题
106
+ md2wx learn-theme ./index.html -n "my-custom-theme"
107
+
108
+ # 直接从微信推文 URL 提取主题
109
+ md2wx learn-theme "https://mp.weixin.qq.com/s/xxxxxx" -n "my-custom-theme"
110
+
111
+ # 使用刚刚提取的主题进行排版
112
+ md2wx article.md -t my-custom-theme -c
113
+ ```
114
+
115
+ ---
116
+
117
+ ### 5. 原生发布至微信公众号草稿箱 (`-p / --publish`)
118
+ ```bash
119
+ # 首次配置微信凭据（永久保存在 ~/.md2wx/config.yaml）
120
+ md2wx config set wechat.appid "wx8d2b2afcxxxxxx"
121
+ md2wx config set wechat.secret "df7fcf8f6xxxxxx"
122
+
123
+ # 一键上传本地配图并直传草稿箱
124
+ md2wx article.md -p
125
+
126
+ # 自定义草稿标题、作者与封面图
127
+ md2wx article.md -p --title "文章大标题" --author "归藏" --cover "assets/cover.png"
128
+ ```
129
+
130
+ ---
131
+
132
+ ### 6. 排版兼容性与合规体检 (`check`)
133
+ ```bash
134
+ # 检查 Markdown 或 HTML 在微信平台上的兼容性与合规隐患
135
+ md2wx check article.md
136
+ ```
137
+
138
+ ---
139
+
140
+ ### 7. 查看主题与版本信息
141
+ ```bash
142
+ # 列出所有已安装的排版主题
143
+ md2wx themes
144
+
145
+ # 查看全局帮助
146
+ md2wx --help
147
+
148
+ # 查询版本号
149
+ md2wx --version
150
+ ```
151
+
152
+ ---
153
+
154
+ ## 🎨 扩展排版语法支持
155
+
156
+ `md2wx` 除了标准 Markdown 语法外，还原生支持现代推文所需的扩展容器组件：
157
+
158
+ ### 1. 居中高亮卡片（纯净无图标）
159
+ ```markdown
160
+ > 运行中的系统，就是一棵由配置组装出来的插件树。
161
+ ```
162
+
163
+ ### 2. 白底描边项目卡片 (`::: card`)
164
+ ```markdown
165
+ ::: card 所以我做了 Pilot Harness。
166
+ https://github.com/op7418/pilot-harness
167
+ :::
168
+ ```
169
+
170
+ ### 3. 实心品牌色引导横幅 (`::: banner`)
171
+ ```markdown
172
+ ::: banner 如果觉得有需要，或者是想尝试一下，可以到这里试试：
173
+ https://github.com/op7418/pilot-harness
174
+ :::
175
+ ```
176
+
177
+ ### 4. 结尾星标装帧分隔符
178
+ 在独立一行输入 `✦` 或 `✧`，将自动渲染为微淡居中装帧效果。
179
+
180
+ ---
181
+
182
+ ## 📄 开源协议
183
+
184
+ MIT License
md2wx_cli-0.2.0/README.md ADDED
@@ -0,0 +1,169 @@
1
+ # md2wx
2
+
3
+ > 🚀 **轻量、确定性、高保真度的 Markdown 转微信公众号排版 CLI 工具**。
4
+ >
5
+ > 深度支持全内联 CSS 注入、5 大精选排版主题、多主题画廊一键对比、微信推文一键抓取逆向、主题智能提取、公众号官方 API 直传草稿箱与排版体检诊断。
6
+
7
+ ---
8
+
9
+ ## ✨ 核心特性
10
+
11
+ - 🎨 **极简现代排版与精选主题栈**：
12
+ - **`default`（默认）**：现代极简杂志编辑风（Noto Serif 宋体衬线大标题、Slate-600 通透正文、曜石黑字重层次、居中浅蓝高亮胶囊、实心品牌色横幅与图片弥散阴影）。
13
+ - **`github-tech`**：经典 GitHub 开发者科技风（深炭黑标题、底边细分割线、OneDark 代码高亮）。
14
+ - **`bauhaus`**：包豪斯艺术几何设计风。
15
+ - **`bold-green`**：清新高对比度科技绿。
16
+ - **`bold-navy`**：深邃藏青商务编辑风。
17
+ - 🖼️ **多主题交互式对比画廊 (`gallery`)**：一键生成全主题交互式 HTML 预览画廊，直接在浏览器中秒级切换对比排版效果。
18
+ - 📥 **微信推文一键抓取与逆向 (`fetch`)**：输入任意微信公众号文章 URL，自动下载全部配图并逆向转换为纯净 Markdown，自动识别居中高亮卡片、白底项目卡片与实心横幅。
19
+ - 🪄 **主题深度逆向提取 (`learn-theme`)**：支持从本地目录、HTML 文件或推文 URL 自动提取双字体栈、标题边框、加粗字重、Callout 风格与图片阴影，缺失组件由 `github-tech` 安全兜底。
20
+ - 🚀 **原生官方 API 直传微信草稿箱 (`-p / --publish`)**：直接集成微信公众平台官方接口，自动将本地配图上传至微信永久素材图床，一键推送到公众号草稿箱（支持 `~/.md2wx/config.yaml` 免密保存）。
21
+ - 📋 **系统剪贴板一键直达 (`-c`)**：直接将富文本 HTML 写入系统剪贴板（含 Windows `CF_HTML` 协议与 `span[leaf]` 防样式丢失保护），进入微信公众号编辑器 `Ctrl+V` 即可完美粘贴。
22
+ - 🩺 **微信排版兼容性与合规体检 (`check`)**：内置 16+ 条微信富文本平台硬规则检测（拦截非法 CSS、缺失图片、未脚注外链等）。
23
+
24
+ ---
25
+
26
+ ## 📦 快速安装与即用
27
+
28
+ ### 1. 免安装即用（推荐）
29
+ ```bash
30
+ uvx md2wx article.md -c
31
+ ```
32
+
33
+ ### 2. 全局标准安装
34
+ ```bash
35
+ pip install md2wx
36
+ ```
37
+
38
+ ### 3. 本地源码安装
39
+ ```bash
40
+ git clone https://github.com/your-name/md2wx.git
41
+ cd md2wx
42
+ pip install -e .
43
+ ```
44
+
45
+ ---
46
+
47
+ ## 📖 核心命令与用法
48
+
49
+ ### 1. 基础转换与排版
50
+ ```bash
51
+ # 转换 Markdown 为微信 HTML 片段并直接复制到系统剪贴板（默认使用 default 杂志风）
52
+ md2wx article.md -c
53
+
54
+ # 输出为 HTML 文件
55
+ md2wx article.md -o output.html
56
+
57
+ # 指定精选主题（如 github-tech）
58
+ md2wx article.md -t github-tech -c
59
+
60
+ # 生成包含完整 <html> 骨架的独立全页面（适合本地双击预览）
61
+ md2wx article.md -o preview.html --full-page
62
+
63
+ # 支持标准输入管道
64
+ cat article.md | md2wx -c
65
+ ```
66
+
67
+ ---
68
+
69
+ ### 2. 多主题交互式画廊对比 (`gallery`)
70
+ ```bash
71
+ # 一键生成全主题交互式对比页面并在默认浏览器打开
72
+ md2wx gallery article.md -o gallery.html --open
73
+ ```
74
+
75
+ ---
76
+
77
+ ### 3. 抓取微信推文并逆向为 Markdown (`fetch`)
78
+ ```bash
79
+ # 从微信推文在线 URL 抓取正文与图片，生成高质量 Markdown
80
+ md2wx fetch "https://mp.weixin.qq.com/s/xxxxxx" -o "article.md"
81
+ ```
82
+
83
+ ---
84
+
85
+ ### 4. 学习与逆向提取主题 (`learn-theme`)
86
+ ```bash
87
+ # 从本地设计快照目录提取主题并保存
88
+ md2wx learn-theme --dir ./my_design_folder -n "my-custom-theme"
89
+
90
+ # 从单个 HTML 文件提取主题
91
+ md2wx learn-theme ./index.html -n "my-custom-theme"
92
+
93
+ # 直接从微信推文 URL 提取主题
94
+ md2wx learn-theme "https://mp.weixin.qq.com/s/xxxxxx" -n "my-custom-theme"
95
+
96
+ # 使用刚刚提取的主题进行排版
97
+ md2wx article.md -t my-custom-theme -c
98
+ ```
99
+
100
+ ---
101
+
102
+ ### 5. 原生发布至微信公众号草稿箱 (`-p / --publish`)
103
+ ```bash
104
+ # 首次配置微信凭据（永久保存在 ~/.md2wx/config.yaml）
105
+ md2wx config set wechat.appid "wx8d2b2afcxxxxxx"
106
+ md2wx config set wechat.secret "df7fcf8f6xxxxxx"
107
+
108
+ # 一键上传本地配图并直传草稿箱
109
+ md2wx article.md -p
110
+
111
+ # 自定义草稿标题、作者与封面图
112
+ md2wx article.md -p --title "文章大标题" --author "归藏" --cover "assets/cover.png"
113
+ ```
114
+
115
+ ---
116
+
117
+ ### 6. 排版兼容性与合规体检 (`check`)
118
+ ```bash
119
+ # 检查 Markdown 或 HTML 在微信平台上的兼容性与合规隐患
120
+ md2wx check article.md
121
+ ```
122
+
123
+ ---
124
+
125
+ ### 7. 查看主题与版本信息
126
+ ```bash
127
+ # 列出所有已安装的排版主题
128
+ md2wx themes
129
+
130
+ # 查看全局帮助
131
+ md2wx --help
132
+
133
+ # 查询版本号
134
+ md2wx --version
135
+ ```
136
+
137
+ ---
138
+
139
+ ## 🎨 扩展排版语法支持
140
+
141
+ `md2wx` 除了标准 Markdown 语法外，还原生支持现代推文所需的扩展容器组件：
142
+
143
+ ### 1. 居中高亮卡片（纯净无图标）
144
+ ```markdown
145
+ > 运行中的系统，就是一棵由配置组装出来的插件树。
146
+ ```
147
+
148
+ ### 2. 白底描边项目卡片 (`::: card`)
149
+ ```markdown
150
+ ::: card 所以我做了 Pilot Harness。
151
+ https://github.com/op7418/pilot-harness
152
+ :::
153
+ ```
154
+
155
+ ### 3. 实心品牌色引导横幅 (`::: banner`)
156
+ ```markdown
157
+ ::: banner 如果觉得有需要，或者是想尝试一下，可以到这里试试：
158
+ https://github.com/op7418/pilot-harness
159
+ :::
160
+ ```
161
+
162
+ ### 4. 结尾星标装帧分隔符
163
+ 在独立一行输入 `✦` 或 `✧`，将自动渲染为微淡居中装帧效果。
164
+
165
+ ---
166
+
167
+ ## 📄 开源协议
168
+
169
+ MIT License
md2wx_cli-0.2.0/pyproject.toml ADDED
@@ -0,0 +1,29 @@
1
+ [build-system]
2
+ requires = ["setuptools>=68"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "md2wx-cli"
7
+ version = "0.2.0"
8
+ description = "轻量级 Markdown 转微信公众号 HTML CLI 工具（支持剪贴板直达、主题提取、WeChatSync 联动）"
9
+ readme = "README.md"
10
+ requires-python = ">=3.11"
11
+ license = "MIT"
12
+ dependencies = [
13
+ "markdown>=3.10",
14
+ "beautifulsoup4>=4.14",
15
+ "cssutils>=2.11",
16
+ "pyyaml>=6.0",
17
+ "Pygments>=2.17",
18
+ ]
19
+
20
+ [project.scripts]
21
+ md2wx = "md2wx.cli:main"
22
+
23
+ [tool.setuptools.packages.find]
24
+ where = ["src"]
25
+
26
+ [tool.setuptools.package-data]
27
+ md2wx = [
28
+ "themes/*.yaml",
29
+ ]
md2wx_cli-0.2.0/setup.cfg ADDED
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
md2wx_cli-0.2.0/src/md2wx/__init__.py ADDED
@@ -0,0 +1,3 @@
1
+ """md2wx — Markdown to WeChat HTML CLI tool."""
2
+
3
+ __version__ = "0.2.0"