安装

fmtagno 是一个单独的可执行文件，不依赖 Word、LibreOffice 或别的程序。下载下来放进 PATH 就能用。

下载预编译版

打开 GitHub Releases，找到最新的预发布版。
按你的系统下载压缩包。现在有三种：
- macOS Intel（x86_64）
- macOS Apple Silicon（arm64）
- Linux x86_64
用同一页的 SHA256SUMS 核对一下（可选）：
终端窗口
```
shasum -a 256 -c SHA256SUMS --ignore-missing
```

解压，找到里面的 fmtagno 文件，放进 PATH 里的目录，比如 ~/.local/bin：

tar -xzf 下载的文件.tar.gz
mkdir -p ~/.local/bin
mv 解压出来的路径/fmtagno ~/.local/bin/

看看装好没有：

fmtagno --version
# fmtagno 0.1.0-alpha.2

macOS 第一次运行可能提示「无法验证开发者」。到「系统设置 → 隐私与安全性」里点「仍要打开」，或者执行：

xattr -d com.apple.quarantine ~/.local/bin/fmtagno

要装 Rust（2024 edition，也就是 1.85 以上）。编译 Typst 很吃内存，建议留 4 GB 以上。

git clone https://github.com/reiy-leo/fmtagno.git
cd fmtagno
cargo build --release
./target/release/fmtagno --version

docx：只写字体名，用户打开时用自己电脑上的字体。
html：同上，交给浏览器。
pdf：字体在渲染时嵌进文件，所以要在你这台机器上找得到。默认按这个顺序找中文字体：苹方（PingFang SC）、冬青黑体、Noto Sans CJK SC、思源黑体、微软雅黑。都没有时退回 Typst 自带字体，中文可能显示不全。

Linux 上出 PDF，先装一套中文字体：

# Debian / Ubuntu
sudo apt install fonts-noto-cjk

快速上手：写一份 JSON，出三种文件。