42md CLI 主命令与架构大升级：三类命令一目了然

42md CLI 这一轮把命令体系做了一次梳理。三类命令各司其职：

42md <文件 / URL>          ← 主命令：格式转换（非 md → md）
42md tools <name> ...      ← tools 子命令：加工 / 导出 / 采集
42md auth / upgrade / help ← 辅助命令：账户 / 升级 / 帮助

这篇分别讲每一类，并对应到 42md 产品功能的「知识获取 / 知识工具」和 tools 子命令树下的三组工具。

产品功能 vs 命令归属

42md 这一轮把产品功能 + tools 子命令树整理成「知识获取 + 三组知识工具」：

产品板块	组	输入 → 输出	命令归属
知识获取	格式转换	非 md → md	主命令 `42md xxx.pdf`
知识工具 · 第一组	二次处理	md → md	`tools lint` / `translate` / `improve` / `hotwords`
知识工具 · 第二组	知识导出	md → 任意	`tools md2pdf` / `md2docx` / `md2epub` / `md2html` / `md2wechat`
知识工具 · 第三组	知识效率（CLI 仅）	URL → 文件	`tools download` / `tools screenshot`

第一、第二组在 webapp 都有等价入口（知识库笔记顶部「二次处理」/「下载」下拉）。第三组目前 CLI 独占——webapp 端能力随产品演进逐步开放。

下面分别讲三类命令。

一、主命令：把各类格式转成 Markdown

主命令承担一件事：把非 Markdown 文件转成高质量 Markdown。

42md report.pdf            # PDF → Markdown
42md slides.pptx           # PPT → Markdown
42md invoice.ofd           # OFD 电子发票 → Markdown
42md lecture.mp3           # 音频 → Markdown（按段落 + 时间戳）
42md scan.pdf -q           # 扫描件 PDF + AI OCR
42md https://example.com   # 网页 → Markdown

自动识别输入格式，分发到合适的解析路径。当前支持 42+ 种文件类型：

类别	格式
办公文档	DOCX / XLSX / PPTX / TXT / OFD
PDF	数字 PDF / 扫描件 PDF（自动 AI OCR）
苹果 iWork	Keynote / Pages / Numbers
电子书 / 学术	EPUB / MOBI / AZW3 / Typst / BibTeX / IPYNB
视听	图片识字 / 音频转录 / 字幕（SRT / VTT / ASS）
网页	URL 单页 / 整站抓取
其他	CSV / HTML / 代码笔记

每种格式都有真实样本可点开看：演示中心。

主命令的本轮亮点：

AI OCR 单次上限拉到 1000 页：博士论文 / 长篇法律文件 / 多卷古籍，一次性跑完不用手动分批
网页全页抓取 + 整站批量：单 URL 转 Markdown / 一个根 URL 自动遍历整站文章
partial-failure 友好：批量处理时若中间几张失败，inline 显示「N 张已完成 / M 张失败」，不再等整批结束才报告

二、tools 子命令：md 拿到手之后做的所有事

主命令只管「拿到 Markdown」。拿到之后想做什么？走 tools 子命令树：

# 第一组：二次处理（md → md）
42md tools lint         # 版式优化（免费）
42md tools translate    # AI 翻译（33 种语言）
42md tools improve      # AI 文本优化（4 种内置模板）
42md tools hotwords     # AI 热词（webapp 即将上线，CLI 已可用）

# 第二组：知识导出（md → 任意格式，全部免费）
42md tools md2pdf       # 转 PDF（数学公式 / 中英混排）
42md tools md2docx      # 转 Word（可继续批注）
42md tools md2epub      # 转 EPUB 电子书
42md tools md2html      # 转独立单文件 HTML
42md tools md2wechat    # 转微信公众号 HTML

# 第三组：知识效率（URL → 文件，CLI 仅，免费）
42md tools download     # 整站资源批量下载
42md tools screenshot   # 网页全页截图

# 探索 / 帮助
42md tools list         # 列出全部工具
42md tools info <name>  # 查看某个工具详细元数据

每个工具自带 --help：

$ 42md tools translate --help
Markdown 翻译（消耗 AI 生成额度）

Usage: 42md tools translate [OPTIONS] [INPUTS]...

Options:
      --target <TARGET>  目标语言（默认中文）
  -y, --yes              非交互模式跳过 Y/n 确认
  -h, --help             Print help

一行命令一件事，不必记一长串 flag 组合。

升级后部分工具的入口从主命令 flag 归位到 tools 子命令树（变化范围有限，老命令直接跑会拿到友好提示告诉新写法）：

老写法	新写法
`42md essay.md`	`42md tools lint essay.md`
`42md report.md -t en`	`42md tools translate report.md --target en`
`42md *.md hotwords`	`42md tools hotwords *.md`
`42md ss https://example.com`	`42md tools screenshot https://example.com`

「知识工具」（10+ 工具）的细节会在「知识工具大升级」系列里逐篇展开。

三、辅助命令：账户 / 升级 / 帮助

剩下的是辅助类命令，使用频率低但必要：

# 账户
42md auth login         # 登录拿到 access token
42md auth logout        # 注销
42md auth status        # 查看当前账号 + 余额

# 升级
42md upgrade            # 显式升级到最新版（不等自动更新）
42md upgrade --check    # 只检查不下载

# 帮助
42md --help             # 全局帮助
42md <command> --help   # 子命令帮助

辅助命令的本轮亮点：

42md auth status 显示账号 + 双套额度（AI 生成 / 网页获取），不用打开浏览器
42md upgrade 跑得稳：版本对齐检查、防回退、断点续传，配合上一篇讲的自动更新使用
42md --help 信息分组：主命令 / tools / 辅助三大块，第一次看也能快速定位

四、配额体系：两套独立额度

两套额度互不干扰：

额度	计费单位	哪些操作消耗
AI 生成	按千字（字符 / 1000）	AI 识别 / AI 转录 / translate / improve / hotwords
网页获取	按篇（一个 URL / 一个文件 = 1 篇）	主命令抓网页 / tools download

tools lint 和 5 个 md2x 导出工具免费转换——纯本地结构化处理，不消耗任何额度。

每次 AI 调用前显示「预估消耗 + 当前余额」二次确认。

五、典型工作流

把三类命令串起来：

# 工作流 1：会议纪要全链路
42md meeting.mp3                          # 主命令：音频 → Markdown
42md tools lint meeting.md --fix          # tools 加工：版式优化
42md tools md2docx meeting.md             # tools 导出：转 Word 给同事批注

# 工作流 2：博客投稿 + 公众号发布
42md tools improve draft.md --template writing_master   # AI 改写
42md tools md2pdf article.md              # PDF 投稿
42md tools md2wechat article.md           # 公众号粘贴版

# 工作流 3：研究某领域
42md tools download https://research.example.com/papers   # 整站资源批量下载
42md *.pdf -q                             # 主命令批量 OCR
42md tools hotwords corpus/*.md           # AI 热词建词库

六、Webapp 入口

不想用命令行？同样的三类工作流在 42md.cc 拖拽即可：

首页：拖文件 / 贴 URL 直接转 Markdown（主命令等价）
「我的知识库」：每篇笔记右侧菜单调用 lint / translate / improve / md2pdf 等加工动作（tools 等价）
「演示中心」：/demo 每个工具都有真实样本可点开看效果

Webapp 和命令行共用一套账户和配额——在哪边操作都同步。

系列后续

接下来「知识工具大升级」系列按 webapp 菜单顺序 + 三组分类，每个工具单独一篇（未来新增工具继续延展）：

2026-06-05：知识工具大升级（1）总述 — 10+ 工具一站式

第一组二次处理：

第二组知识导出：

2026-06-13：（5）md2pdf 专业级 PDF
2026-06-15：（6）md2docx Markdown 转 Word
2026-06-17：（7）md2epub Markdown 转 EPUB
2026-06-19：（8）md2html + md2wechat 双形态 HTML

第三组知识效率（CLI 仅）：

2026-06-21：（9）download 整站资源批量下载
2026-06-23：（10）screenshot 网页全页截图

立即体验

# 安装或升级（CLI 自动更新已内置）
curl -fsSL https://42md.cc/mac | bash

# 探索三类命令
42md --help
42md tools list
42md auth status

42md.cc 网页拖拽也可以。

42md — 你的 AI 知识快刀。更快地获取、更深地编译、更好地策展、更强的工具。

活水 AI 实验室（42ailab） — 源自 2023 年成立的活水智能团队，致力于以认知科学为基石，推动人工智能与人类智能的深度融合与科学创新。

官网：https://42md.cc