Repository navigation
Releases
v1.9.1: 落地页主题预览联动与窄屏溢出修复
v1.9.1: 落地页主题预览联动与窄屏溢出修复
v1.9.0 之后的一轮落地页修复。官网演示区的主题切换从"只换三条颜色"改成整块预览骨架联动,同时把窄屏下撑出横向滚动条的问题处理掉。
落地页演示区
- 右侧微信模拟视窗整体由
data-preview-theme驱动:终端黑、复古报刊、先锋野兽派各自还原自己的深色底、衬线双线、粗黑硬投影与代码配色,切换主题不再只有页眉一条线变色。 - 主题按钮联动主题色与
aria-pressed状态,预览副标题同步显示当前主题名,方便对照。 - 主题缩略图改为预载完成后再替换,并加点击序号兜底,连点多个主题时不会被慢图覆盖成错位画面;图片加载失败也会恢复亮度,不会一直灰着。
- 750–900 宽度区间收起源码栏,避免左右两栏互相挤压。
移动端适配
- 窄屏隐藏导航里的 Star 按钮并收窄容器内边距,修复 360–414 宽度下导航撑出横向滚动条的问题。
文档
- Studio 的版本速递弹窗同步到 v1.9.0 的发稿体检、发布门禁与大纲导航。
AGENTS.md发布流程新增第 4 步:每次发版必须同步更新记录弹窗,不能只换版本号。
验证
python3 -m pytest200 项通过,Web 端npm test与npm run build无报错。- 在 1920 / 1440 / 1280 / 900 / 768 / 414 / 360 宽度下检查落地页,均无横向滚动条。
v1.9.0: 发稿体检双端对齐
v1.9.0: 发稿体检双端对齐
把 CLI 的发稿规范校验搬进 Web 工作台,同时补齐发布门禁、机器可读报告与几项最基础的编辑体验。
发稿规范校验(双端对齐)
- 规则从 9 条扩到 13 条,
code编号、判定顺序、级别与文案在md2wx/linter.py与web/src/core/lint.js中逐条一致,每条问题都带行号。 - 新增规则:
title-punctuation/digest-punctuation(标题、摘要以句读标点收尾)、emoji-banned(正文与标题禁用 Emoji)、html-unclosed(未闭合的块级 HTML 标签,定为 error)、link-format-invalid(缺协议、含空白、非 http/https)、punctuation-mixed(中文里混用半角标点)。 tests/test_lint_consistency.py在 Node 环境下逐条比对双端问题清单,两份引擎不再有静默分叉的空间。
CLI:发布门禁与 JSON 报告
-p/--publish现在默认先跑一遍校验:存在 error 级问题会在获取凭据、上传图片之前中止,不发出任何网络请求;--no-lint是紧急逃生通道。- 这是行为变更:以前发布只做提示,现在会真的拦下来。
--lint --format json输出单个 JSON 对象(含file、issues、summary),可以直接jq处理,方便接进自己的发布流程。--check-links用线程池并发对正文外链发 HEAD 请求,超时或不通降级为link-timeout/link-unreachable警告,仅供 CLI 使用。
Web 工作台
- 预览区底部常驻体检栏:按 error / warn 分组列出问题,点击条目跳到编辑器对应行,预览同步滚动。
- 存在 error 级问题时阻断复制,避免把排版会崩的正文粘进微信后台。
- 半角标点提供一键修复,只改标点,不动正文其他字符。
- 状态栏常驻正文字数、预计阅读时长与图片数量。
- 新增大纲抽屉,按 H1-H6 生成层级目录,点击定位正文并同步预览视口,Esc 关闭。
- 支持把本地
.md文件直接拖进编辑器打开。
验证
python3 -m pytest200 项通过,Web 端npm test65 项通过,npm run build无报错。- 示例文章与 golden 用例的校验结果为 0 问题,
golden_edge.md稳定产出 1 条title-too-long,双端一致。 - 浏览器实测体检面板、复制阻断、问题跳行、标点修复、大纲定位与拖拽导入均正常,控制台无报错。
v1.8.2: 工具栏换行与预览宽度修复
v1.8.2: 工具栏换行与预览宽度修复
修复 v1.8.1 增加工具栏按钮后,编辑栏被撑宽、右侧预览窗口被挤压的问题。
布局修复
- 编辑区与预览区恢复等宽分配,两侧都允许收缩,不再被工具栏的最小内容宽度撑开。
- 工具栏改为按可用宽度自动换行:宽屏保持一行,窄屏显示两到三行,不再横向滚动或隐藏按钮。
- 清空按钮跟随工具栏一起换行,图片插入浮层在换行后仍能正常展开。
验证
- 在 1920 / 1600 / 1440 / 1280 / 1024 宽度下,编辑区与预览区宽度一致,页面没有横向溢出。
- 新增工具栏按钮功能回归通过,179 项 Python 测试与 Web 构建通过。
v1.8.1: 示例、工具栏与默认主题
v1.8.1: 示例、工具栏与默认主题
这一版把默认体验重新收拾了一遍:打开工作台看到的第一篇文章,能直接当语法手册用;编辑器上方的按钮补齐了常用写法;默认主题换成更醒目的先锋野兽派。
默认示例覆盖全部语法
Web 工作台与 CLI 现在共用仓库根目录的 sample_article.md,示例只有一份,不会再出现两边内容对不上的情况。
示例按段落覆盖了当前支持的写法:
- Frontmatter 元信息、ATX 与 Setext 标题、H1 - H6;
- 粗体、斜体、粗斜体、删除线、荧光高亮、行内代码、下划线、上下标;
- 转义字符、行尾双空格与反斜杠硬换行;
- 多级引用、无序/有序/任务列表、嵌套列表;
- 表格对齐、围栏代码块、波浪线围栏、四空格缩进代码;
- 行内公式、块级公式、Mermaid 流程图;
- 独立图片、图注、引用式图片、Obsidian
![[...]]图片; - 行内链接、引用式链接、裸链接、邮箱、文本脚注与参考链接区。
编辑器工具栏补齐
新增 H3、删除线、荧光高亮、行内代码、有序列表、任务清单、数学公式、Mermaid 八个按钮。按钮变多后工具栏支持横向滚动,窄屏下不会挤压编辑区。
默认主题改为 acid-bold
CLI、Web 工作台与封面渲染的默认主题统一为 acid-bold(先锋野兽派)。封面预设与未知主题的兜底也同步调整。
已有浏览器如果存过主题选择,会继续沿用 localStorage 里的旧主题;清掉站点数据或重新选择即可切到新默认值。
其他修复
- 预览顶部封面卡片改为从完整原文提取元数据,作者字段现在能正确读取 Frontmatter 的
author,不再固定显示示例作者。 - 顺手更新 README 主题表与教程中的默认主题说明。
v1.8.0: 草稿箱可以反复改了
v1.8.0: 草稿箱可以反复改了
以前改一版就推一版,草稿箱里很快就会堆出好几篇同名文章。这一版把草稿箱从「只管写」补成「能改、能删、能续」:同一篇 Markdown 再发一次,会覆盖上次那篇草稿,而不是新建。
同一文件再次发布 = 覆盖更新
CLI 会在本机记录「Markdown 文件 -> 草稿 ID」的映射,位置在 ~/.config/md2wx/drafts.json,只存草稿 ID、标题与更新时间,不碰正文。
- 首次
md2wx article.md -p:正常新建草稿,并记下映射。 - 再次
md2wx article.md -p:自动走draft/update,覆盖上次那篇草稿,终端会明确提示。 - 想另发一篇:加
--new-draft,忽略本机记录。 - 想覆盖另一篇:
md2wx article.md -p --update-draft <草稿 ID>。
行为变更提醒:同一个文件重复执行 -p,默认结果从「新建草稿」变成「覆盖原草稿」。如果你原本靠重复发布来留多版,请改用 --new-draft。
草稿箱管理命令
# 列出最近 10 篇草稿(标题 / 更新时间 / 草稿 ID),* 表示本机发布过
md2wx --list-drafts
md2wx --list-drafts 20
# 删除草稿,同时清掉本机对应的发布记录
md2wx --delete-draft <草稿 ID>
md2wx --delete-draft <草稿 ID> -y # 非交互环境跳过确认列表走 draft/batchget,删除走 draft/delete,与发布链路共用同一套凭据缓存、Token 失效重试与代理网关约定(WECHAT_PROXY_URL)。
走自建代理网关的用户需要网关同步放行
draft_batchget、draft_update、draft_delete三个动作;wx-serv 侧的代理路由已补齐,重新部署网关后生效。
降级与边界
- 本机记录的草稿已在公众号后台被删除时,
draft/update返回 40007,CLI 会自动清掉失效映射并改为新建草稿,不会卡在半路。 - 显式
--update-draft指定的草稿不存在时直接报错,不会偷偷新建,避免发错位置。 --dry-run现在会区分draft/add与draft/update,并打印对应的 media_id,仍然不获取凭据、不发任何请求。- 从 stdin 读入、不带文件路径时,映射退化为按标题记录,避免误覆盖无关文章。
校验
- Python 单测 179 项通过(新增 27 项:列表归一化、分页上限、代理通道、更新 payload 形状、Token 重试、映射读写与清理、CLI 列表/删除/续更演练)。
- Web 端未改动,
npm run build校验版本号注入正常。
v1.7.0: 兼容 Obsidian 图片语法
v1.7.0: 兼容 Obsidian 图片语法
Obsidian 插入本地图片用的是 ![[文件名]] 写法,MD2WX 之前只认标准 Markdown 的 ,这类图片会被当成普通文本:渲染不出图,发布时也扫不到、不会上传微信 CDN。本版把这套语法接进整条图片管道。
渲染:识别 Obsidian 图片语法
新增一层归一化预处理,把 wiki 图片就地转成标准 Markdown,后续的内联/块级图片、CDN 换链、外链检测与 lint 全部复用原有逻辑。
![[架构图.png]]→![[架构图.png|系统架构]]→(别名作为 alt)![[架构图.png|320]]、![[架构图.png|100x200]]→ 尺寸别名丢弃(标准 Markdown 无宽度语义)[[架构图.png]](不带!)→ 同样转图片,但仅当文件名带图片扩展名;[[某篇笔记]]等笔记链接保持原样- 文件名含空格 → 空格转义为
%20,下游unquote还原,本地路径仍能正确解析并上传
归一化会跳过围栏代码块与行内代码,代码里写的 ![[x.png]] 字面量不受影响;函数幂等,重复调用结果不变。
双端同步
CLI 与 Web Studio 使用同一套规则:parser.py 与 parser.js 各实现一份镜像函数,并接入渲染与外链检测入口。CLI 在解析正文后先归一化,让发布前的图片扫描能命中并上传微信 CDN;--lint 的 alt 缺失、重复图片检查也覆盖这套写法。原有标准 Markdown 图片的行为不变。
校验
- Python 单测 152 项通过(新增 9 项:wiki 图片块级/内联、别名与尺寸、空格转义、裸链接扩展名甄别、代码跳过、image_map 换链、幂等,以及 2 项 lint)。
- Web 端 52 项通过(新增 4 项同源用例),
npm run build无错误。 - 双端 golden 一致性测试新增 wiki 图片语料,逐主题比对通过。
v1.6.1: 草稿箱常驻侧栏与引用分行修复
v1.6.1: 草稿箱常驻侧栏与引用分行修复
本次更新两件事:草稿箱从头部浮层搬进编辑器左侧常驻,引用块恢复逐行换行。
Web Studio:草稿箱改为常驻侧栏
- 「草稿箱」从头部下拉浮层移到 Markdown 编辑器的左侧,成为常驻栏:顶部是列表与「新建」,底部显示草稿篇数与「本地自动保存」。
- 编辑区与预览区相应收窄;窗口宽度低于 1180px 时侧栏自动压缩到 188px,保证仿真实机预览不被挤坏。
- 列表在编辑过程中自动刷新(标题、相对时间、活动草稿高亮),内部做了 500ms 节流与指纹比对,只在标题、时间或活动态真的变化时才重建 DOM,输入时不会反复重绘。
- 草稿的载入、新建、删除、自动保存行为与 v1.6.0 一致,
localStorage数据格式未变,升级不会丢稿。
渲染:引用块恢复逐行换行(行为变更)
v1.5.0 引入 CommonMark 软换行语义后,文章开头常见的作者、标签、摘要等连续引用行,会因中文相邻字符被直接拼接成一段,推送微信后塌成一整行。现在:
- 引用块内层按作者手写的分行渲染,行与行之间插入
<br/>,>空行生成的间隔、嵌套引用、引用内列表照旧。 - 引用块之外的普通段落仍保持软换行语义:源码为排版而折的行不会变成换行,中文段落的拼接行为不变。
- 行尾已有两个空格或反斜杠的硬换行标记不会重复插入换行符。
- CLI 与 Web 端仍是同一套语义,双端 golden 一致性测试继续通过。
如果你原本依赖「引用块内多行自动拼接成一段」的写法,请把该段写成单独一行。
校验
- Python 单测 143 项通过(新增 3 项:引用块分行、硬换行标记不重复、引用块外软换行仍生效)。
- Web 端 48 项通过(新增 2 项同源用例),
npm run build无错误,双端渲染一致性比对通过。
v1.6.0: 本地草稿箱、发布演练与发稿体检增强
v1.6.0: 本地草稿箱、发布演练与发稿体检增强
本次更新围绕"发布前后少踩坑"补了三块能力:Web Studio 有了本地草稿箱,CLI 有了发布演练与凭据缓存,发稿体检从 5 条规则扩到 9 条。
Web Studio:本地草稿箱
- 工具栏新增「草稿箱」浮层:多篇草稿自动保存、历史切换、新建与删除,最多保留 20 篇(超出按更新时间淘汰最旧,活动草稿不淘汰)。
- 草稿标题自动取自 frontmatter 的
title,其次取首个 H1,都没有则记为「未命名草稿」。 - 旧版单草稿键
md2wx_draft在首次进入时一次性迁移为列表首项,原键保留不清除,回滚旧版本不会丢稿。 - 存储超限时降级为剔除内嵌图片数据后再写入;存储完全不可用时明确提示本次未持久化,编辑器内容不受影响。
CLI:发布演练 --dry-run
md2wx article.md -t tech-blue -p --dry-run完整走完渲染、封面解析与 Mermaid / 公式截图流程,然后打印将上报 draft/add 的 payload 摘要(标题、作者、摘要、封面裁切坐标、原文链接)并退出。整个过程不获取凭据、不上传素材、不推送草稿,适合发布前核对字段。
CLI:凭据缓存与失效重试
- access_token 增加本地缓存
~/.config/md2wx/token_cache.json(按 app_id 隔离),未过期直接复用,减少 token 接口调用。 - 按微信 7200 秒有效期预留 5 分钟安全余量,距过期不足 5 分钟即视为失效。
- 草稿链路遇到 40001 / 42001 / 40014 时,自动刷新凭据并整链路重试一次,重试覆盖封面素材上传与
draft/add两个消费环节。 - 新增
WeChatApiError携带微信官方 errcode,供调用方按错误码分流。
CLI:发稿体检 --lint 新增 4 条规则
- 标题层级跳跃:H1 之后直接出现 H3 及更深层级(只提示首个跳跃点)。
- 围栏代码块缺少语言标注:影响语法高亮与移动端阅读;纯文本块可忽略。
- 图片缺少 alt 描述文本:微信图片折叠时无法展示语义。
- 同一图片 URL 被重复引用:发布时会重复上传与换链,建议复用同一处引用。
规则扫描会正确跳过围栏代码块内的 # 注释行,避免误报。
渲染
- GFM 删除线现同时支持
~text~与~~text~~两种写法。 - Mermaid 图表与数学公式截图失败时不再静默降级:CLI 会明示有多少处已降级为文本形态,提示发布前真机确认。
校验
- Python 单测 140 项通过(新增 6 项覆盖 token 缓存),Web 端 46 项通过,
npm run build无错误。
v1.5.0: 完整 Markdown 语法支持,双端对齐 CommonMark + GFM
v1.5.0: 完整 Markdown 语法支持,双端解析引擎对齐 CommonMark + GFM
本次更新将 CLI 与 Web 双端解析器升级至完整支持 CommonMark + GFM 及常用扩展语法,补齐 20+ 项历史缺口,双端渲染产物经 13 主题 × 全语法夹具逐字节一致性测试验证。
新增语法支持
块级
- 段落软换行合并:连续多行合并为同一段落(CJK 相邻直接拼接、英文补空格),行尾两空格或反斜杠 = 硬换行
<br> - 有序列表:
1./2)标记,保留源文档编号 - 多层嵌套列表:缩进层级无限深度,无序/有序/任务项任意混合嵌套
+列表标记、四空格缩进代码块- 多级嵌套引用:
>>递归渲染内层引用容器 ~~~波浪围栏与 3+ 字符围栏、分割线变体(----、* * *、- - -)- Setext 标题(文字下
===/---),与分割线智能消歧 - h4-h6 六级标题:新增派生默认样式(主题可用
styles.h4/h5/h6可选覆盖);标题文本现支持行内格式化(加粗/链接等) - 表格列对齐:
:---/:---:/---:逐列生效,支持\|转义管道
行内
- 反斜杠转义(
\*\_等按字面输出) __加粗__/_斜体_(词内下划线不误触发)- 双反引号行内代码(
`x`内含单反引号) - 尖括号自动链接
<https://...>与邮箱 - 段落中行内图片、参考式链接/图片
[text][ref] [^1]编号脚注:并入文末参考链接区统一编号,支持定义正文内格式化==高亮==:主题色荧光笔效果- HTML 实体透传:
©&等不再被双重转义 - 安全 HTML 白名单:
<b> <u> <mark> <sub>等无属性标签放行,其余仍转义显示
行为变更提示
- 段落内连续单换行现在合并为同一段(符合 Markdown 标准);此前依赖「单换行即分段」的旧文档请使用空行分段或行尾两空格硬换行。
质量保障
- golden 一致性夹具扩展至全语法覆盖,13 主题 × 双端逐字节比对通过
- 测试规模:Python 97 → 123,Web Node 20 → 45
Full Changelog: v1.4.0...v1.5.0
v1.4.0: 主题库扩容至 13 套:自然系与低饱和柔系上线
v1.4.0: 主题库扩容至 13 套:自然系与低饱和柔系上线
本次更新为主题库新增 4 套浅色主题(9 → 13),覆盖自然系与低饱和柔系两大方向,全部经过真机排版节奏与封面引擎像素级调校。
新增主题
自然系
- 森野墨绿 (forest-green):米纸底色 + 衬线字体书卷气,深林墨绿点缀、菱形项目符号与渐变分割线。适合自然随笔、慢生活记录与深度书评。
- 陶土亚麻 (terracotta-clay):亚麻米色底 + 陶土橙棕低饱和主色,方块列表与典雅大引号,手作陶艺般温润质朴。适合生活方式、器物手作与人文随笔。
低饱和柔系
- 莫兰迪雾灰 (morandi-mist):雾霾蓝灰低饱和调,极简排版节奏。首次启用
clean_flat平底代码块与学术三线表组合。适合文艺随笔、影评乐评与极简主义书写。 - 奶油粉彩 (pastel-cream):奶油白底 + 豆沙玫瑰柔粉,胶囊标题、气泡引言卡与轻甜治愈氛围。适合情感随笔、手账日记与美学生活分享。
全栈同步
- 每套新主题完整接入双端渲染引擎(CLI
parser.py/ Webparser.js,golden 一致性测试自动覆盖 13 主题比对) - Cover Studio 封面预设三处登记(Python / JS / CSS),含微信头条卡片与 1:1 分享方图双比例封面
- 随包分发 2.35:1 静态兜底封面,落地页主题画廊新增 4 格预览(含 2x 超清截图与预览 HTML)
使用方式
md2wx article.md -t forest-green -c
md2wx article.md -t morandi-mist -pWeb Studio 主题下拉与封面工坊同步可选。
Full Changelog: v1.3.0...v1.4.0
Full Changelog: v1.3.0...v1.4.0