跳转到主内容
全部文档

CLI 命令参考

四类命令

42md 命令分四类，各司其职：

bash
42md <文件 / 网址>        # 主命令：格式转换（非 md → md）42md tools <name> ...    # tools 子命令：加工 / 导出 / 效率 / 整理42md kb <动作> ...        # kb 子命令：云端知识库（检索 / 取用 / 同步）42md auth / upgrade      # 辅助命令：账户 / 升级

主命令：知识获取

只需记住一个模式：42md <文件或网址>

bash
42md paper.pdf                 # PDF → Markdown42md scan.pdf --ocr            # 扫描件 AI 识别（消耗配额）42md report.pdf --pages 1-10   # 只转指定页（1-10 / 1,3,5-8）42md lecture.mp3               # 音频 → Markdown42md https://example.com       # 网页单篇 → Markdown42md report.docx               # Office / OFD / iWork / 电子书等 42+ 格式42md *.pdf                     # 批量转换当前目录所有 PDF42md ./papers/                 # 转换整个目录

主命令选项：

参数说明
--ocrAI 识别模式（扫描件 / 图片，消耗配额；旧名 -q 仍可用）
--pages <范围>只转指定页（如 1-10 / 1,3,5-8）；普通提取和 AI 识别都支持
-o <路径>指定输出文件路径
-w <数量>并发数（默认按任务类型自动选择）
-y跳过付费操作的二次确认（脚本场景）

大规模批量：42md batch

上千、上万篇要一次处理时，用 42md batch。它和主命令走同一转换管线，额外提供为大批量而设的可靠性选项——个别坏文件不拖垮整批，跑断了还能接着上次继续。

bash
42md batch ~/papers -o out/            # 批量转换整个目录（自动递归，产物落 out/）42md batch ~/papers --timeout 120      # 单篇墙钟超时 120 秒，超时记为失败、跳过、继续（0 = 不限）42md batch ~/papers -o out/            # 同一 -o 目录再运行一次 = 断点续传，已转好的自动跳过42md batch --from-list urls.txt -o out/  # 从链接清单批量抓取，边下载边转换42md batch ~/scans --ocr --engine local  # 扫描件走本机活水模型识别，零计费 · Pro / Pro+

batch 专属选项：

参数说明
--timeout <秒>单篇墙钟超时（默认 60；超时记为失败、批量继续；0 = 不限）
--from-list <文件>从文本文件读链接清单（每行一个），边下载边转换（需配 -o）
-o <目录>输出目录；指定后自动启用断点续传
-w <数量>转换并发（默认按核数 / 内存自适应，内存吃紧自动降并发）
--images连 PDF 里的图片一起导出（默认不导，省内存、更快）
--engine local强制走本机活水模型（连不上会报错，不偷偷改用云端）
-y跳过付费操作二次确认（非交互脚本必备）

tools 子命令：拿到 Markdown 之后

bash
# 第一组 二次处理（md → md）42md tools lint essay.md --style wechat              # 版式优化（免费）42md tools translate report.md --target en            # AI 翻译（33 种语言）42md tools improve draft.md --prompt writing_master # AI 优化42md tools hotwords *.md                              # AI 热词建词库
# 第二组 知识导出（md → 任意格式，全部免费）42md tools md2pdf article.md42md tools md2docx article.md42md tools md2epub book.md42md tools md2html page.md42md tools md2wechat article.md
# 第三组 知识效率（URL → 文件，CLI 独占，免费）42md tools download https://site.com --site          # 整站 PDF 批量下载42md tools screenshot https://example.com            # 网页全页截图
# 第四组 文件整理（文件 → 文件，CLI 独占，免费、纯本地）42md tools compress ~/Documents --type pdf --min-size 50MB  # 瘦身整个目录（默认本层，-r 递归）42md tools compress scan.pdf                         # 瘦身单个文件（PDF / 图片）42md tools inspect scan.pdf                          # 体检：体积构成 / 可压空间（也可传目录）42md tools scan ~/Documents --type pdf --format md   # 只发现/审计：列文件、校验真伪、导出 / -0 喂外部42md tools merge chapters/*.md -o book.md            # 多份合并成一份（Markdown 或 PDF）42md tools split big.pdf --by bookmark -o out/       # 一份拆成多份（Markdown 按标题 / PDF 按页 / 书签）
# 探索42md tools list                # 列出全部工具42md tools info <name>         # 查看某个工具详情
/2