Skip to content

Releases

v1.9.1: 落地页主题预览联动与窄屏溢出修复

Choose a tag to compare

@github-actions github-actions released this 12 Nov 07:29

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 pytest 200 项通过,Web 端 npm test 与 npm run build 无报错。
  • 在 1920 / 1440 / 1280 / 900 / 768 / 414 / 360 宽度下检查落地页,均无横向滚动条。

v1.9.0: 发稿体检双端对齐

Choose a tag to compare

@github-actions github-actions released this 22 Oct 06:52

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 pytest 200 项通过,Web 端 npm test 65 项通过,npm run build 无报错。
  • 示例文章与 golden 用例的校验结果为 0 问题,golden_edge.md 稳定产出 1 条 title-too-long,双端一致。
  • 浏览器实测体检面板、复制阻断、问题跳行、标点修复、大纲定位与拖拽导入均正常,控制台无报错。

v1.8.2: 工具栏换行与预览宽度修复

Choose a tag to compare

@github-actions github-actions released this 21 Oct 01:05

v1.8.2: 工具栏换行与预览宽度修复

修复 v1.8.1 增加工具栏按钮后,编辑栏被撑宽、右侧预览窗口被挤压的问题。

布局修复

  • 编辑区与预览区恢复等宽分配,两侧都允许收缩,不再被工具栏的最小内容宽度撑开。
  • 工具栏改为按可用宽度自动换行:宽屏保持一行,窄屏显示两到三行,不再横向滚动或隐藏按钮。
  • 清空按钮跟随工具栏一起换行,图片插入浮层在换行后仍能正常展开。

验证

  • 在 1920 / 1600 / 1440 / 1280 / 1024 宽度下,编辑区与预览区宽度一致,页面没有横向溢出。
  • 新增工具栏按钮功能回归通过,179 项 Python 测试与 Web 构建通过。

v1.8.1: 示例、工具栏与默认主题

Choose a tag to compare

@github-actions github-actions released this 20 Oct 09:46

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: 草稿箱可以反复改了

Choose a tag to compare

@github-actions github-actions released this 20 Oct 09:12

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 图片语法

Choose a tag to compare

@github-actions github-actions released this 16 Oct 02:10

v1.7.0: 兼容 Obsidian 图片语法

Obsidian 插入本地图片用的是 ![[文件名]] 写法,MD2WX 之前只认标准 Markdown 的 ![alt](路径),这类图片会被当成普通文本:渲染不出图,发布时也扫不到、不会上传微信 CDN。本版把这套语法接进整条图片管道。

渲染:识别 Obsidian 图片语法

新增一层归一化预处理,把 wiki 图片就地转成标准 Markdown,后续的内联/块级图片、CDN 换链、外链检测与 lint 全部复用原有逻辑。

  • ![[架构图.png]] → ![](架构图.png)
  • ![[架构图.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: 草稿箱常驻侧栏与引用分行修复

Choose a tag to compare

@github-actions github-actions released this 12 Oct 09:04

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: 本地草稿箱、发布演练与发稿体检增强

Choose a tag to compare

@github-actions github-actions released this 12 Oct 02:39

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

Choose a tag to compare

@github-actions github-actions released this 10 Oct 02:22

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 实体透传:&copy; &amp; 等不再被双重转义
  • 安全 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 套:自然系与低饱和柔系上线

Choose a tag to compare

@zaneven zaneven released this 09 Oct 12:26

v1.4.0: 主题库扩容至 13 套:自然系与低饱和柔系上线

本次更新为主题库新增 4 套浅色主题(9 → 13),覆盖自然系与低饱和柔系两大方向,全部经过真机排版节奏与封面引擎像素级调校。

新增主题

自然系

  • 森野墨绿 (forest-green):米纸底色 + 衬线字体书卷气,深林墨绿点缀、菱形项目符号与渐变分割线。适合自然随笔、慢生活记录与深度书评。
  • 陶土亚麻 (terracotta-clay):亚麻米色底 + 陶土橙棕低饱和主色,方块列表与典雅大引号,手作陶艺般温润质朴。适合生活方式、器物手作与人文随笔。

低饱和柔系

  • 莫兰迪雾灰 (morandi-mist):雾霾蓝灰低饱和调,极简排版节奏。首次启用 clean_flat 平底代码块与学术三线表组合。适合文艺随笔、影评乐评与极简主义书写。
  • 奶油粉彩 (pastel-cream):奶油白底 + 豆沙玫瑰柔粉,胶囊标题、气泡引言卡与轻甜治愈氛围。适合情感随笔、手账日记与美学生活分享。

全栈同步

  • 每套新主题完整接入双端渲染引擎(CLI parser.py / Web parser.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 -p

Web Studio 主题下拉与封面工坊同步可选。

Full Changelog: v1.3.0...v1.4.0

Full Changelog: v1.3.0...v1.4.0