doxx：终端 Word 文档查看器

项目简介

doxx 是一个用 Rust 编写的终端原生 .docx 文档查看器。它让你无需安装 Microsoft Word，就能在命令行中查看、搜索和导出 Word 文档，主打快速、安全、智能的使用体验。

主要功能

• 终端渲染：在终端中显示格式、表格和列表，保留文档结构。
• 公式支持：渲染行内公式和独立公式的 LaTeX 内容。
• 快速搜索：支持在文档中搜索并高亮关键词。
• 智能表格：表格使用 Unicode 边框，并正确处理对齐方式。
• 复制到剪贴板：可直接从终端复制当前内容。
• 多种导出格式：支持 Markdown、CSV、JSON、纯文本和 ANSI 彩色输出。
• 终端图片显示：支持 Kitty、iTerm2、WezTerm 等终端内联显示图片。
• 颜色支持：可在终端中查看 Word 文档的文字颜色。

安装与使用

可通过多种包管理器安装：

brew install bgreenwell/tap/doxx
cargo install doxx
sudo apt install doxx
pacman -S doxx
nix profile install github:bgreenwell/doxx
conda install doxx

也可以从源码构建：

git clone https://github.com/bgreenwell/doxx.git
cd doxx
cargo install --path .

构建要求 Rust 1.70+，Linux 还需要 libxcb。

常用命令示例：

# 查看文档
doxx report.docx

# 搜索内容
doxx contract.docx --search "payment"

# 以大纲视图启动
doxx document.docx --outline

# 导出为不同格式
doxx data.docx --export csv > data.csv
doxx report.docx --export markdown > report.md

# 在支持的终端中显示图片
doxx presentation.docx --images --export text

# 启用颜色渲染
doxx slides.docx --color

导出格式包括 markdown、text、csv、json 和 ansi。ANSI 导出可配合 --terminal-width 和 --color-depth 控制宽度与色彩深度。

可通过配置文件切换 default、vim、less 三种键位预设，也可以自定义按键绑定：

doxx config init
doxx config set keymap.preset vim
doxx config get keymap.preset

注意事项

• CSV 导出只提取文档中的表格，忽略正文文字，适合把结构化数据导入 Excel、Python 或数据库。
• --images 会在 TUI 和 --export text 输出中内联渲染图片；支持 iTerm2、Kitty、WezTerm、Sixel 终端，其他终端有半块字符回退方案。
• 配置文件位置：macOS 为 ~/Library/Application Support/doxx/config.toml，Linux 为 ~/.config/doxx/config.toml，Windows 为 %APPDATA%\doxx\config.toml。

---

本作品整理自 GitHub 开源项目 bgreenwell/doxx，原作者 @bgreenwell，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。