# 常见问题解答 (FAQ)

## 转换相关

### Q: 如何转换为繁体中文？
可以在命令中添加 `--tc` 参数：
```bash
yakultpdf convert sample.md --tc
```
如果是批量模式，也可以同样应用：
```bash
yakultpdf convert --batch docs --tc
```

### Q: 如何批量处理一个目录？
有两种模式：
1. **逐一转换**（每个文件生成一个独立的 PDF）：
   ```bash
   yakultpdf convert --batch docs
   ```
2. **合并转换**（整个目录合并为一个 PDF）：
   ```bash
   yakultpdf convert --dir docs
   ```

### Q: 转换后如何自动打开 PDF？
添加 `-o` 或 `--open` 参数：
```bash
yakultpdf convert sample.md -o
```

## 图片处理

### Q: 如何清理微信文章中的图片？
微信公众号图片通常有防盗链，直接转换会失败。请使用 `mdimage` 工具预先下载：
```bash
yakultpdf mdimage download wechat_article.md --delay 2.0
```
工具会自动使用特殊的 User-Agent 模拟浏览器行为，`--delay` 参数有助于防止被反爬虫限制。

## 配置与调试

### Q: 如何查看当前配置？
使用 `--show-config` 参数可以查看实际生效的配置（合并了配置文件和命令行参数）：
```bash
yakultpdf convert --show-config
```

### Q: 为什么修改了配置文件没生效？
1. 请检查 `mark2pdf.config.toml` 是否位于工作区根目录。
2. 确认没有被命令行参数覆盖（命令行参数优先级更高）。
3. 如果是模板相关配置，请确认没有被文件内部的 frontmatter 覆盖。
