跳转到主要内容
适合终端、脚本、CI 和“先把文件跑通”的场景。如果你还在比较接入方式，先看 入门总览；如果你要把能力接进代码里，去看 SoMark SDK。
1

安装 CLI

Python 和 JavaScript 两个包都自带 somark 命令。
pip install somark
# 或
npm install somark-js
如果全局命令还不可用，Python 先试 python -m somark.cli.main --help，Node.js 先试 npx somark-js --help。
2

配置 API Key

最常见的两种方式是交互式登录，或者直接用环境变量。
somark login

# 或
export SOMARK_API_KEY=sk-your-api-key
3

先解析一个文件

先用单文件同步解析跑通链路，再决定是否加格式、异步和批处理参数。
somark parse ./document.pdf

somark parse ./document.pdf --formats md,json --out ./document.md
4

再处理大文件或批量任务

大文件可以直接异步等待结果，批量任务可以从文件清单读取。
somark parse ./large.pdf --async --wait

somark parse --file-list ./files.txt --out ./parsed/
需要更完整的参数说明时，继续看 CLI & SDK 使用指南。