使用限制与注意事项
为确保最佳使用效果，需特别注意以下事项：
Restrições técnicas
- 文件格式要求：必须是文本型PDF（扫描件图片PDF无法处理）
- Suporte ao idioma chinês：虽然支持中文转换，但路径含中文可能报错
- dependência da rede：必须保持网络连接以调用OpenAI API
使用规范
- Segurança da chave de API：不要将密钥硬编码在脚本中，建议通过环境变量传入
- Manuseio de arquivos grandes：超过50页的文档建议分批次转换
- Validação dos resultados：首次转换后应检查数学公式等特殊内容的准确性
Soluções para problemas comuns
| 问题现象 | 排查步骤 |
|---|---|
| 转换结果乱码 | 检查PDF是否加密或包含特殊字体 |
| 表格识别错位 | 尝试调整main.py中的表格检测参数 |
| API调用失败 | 确认密钥有效性和余额状态 |
遇到持续性问题时，建议到GitHub项目页提交issue并提供测试用例。
Essa resposta foi extraída do artigoMarkPDFDown: converte PDF em Markdown com base em um modelo multimodalO
Não pode ser reproduzido sem permissão:Ferramentas de produtividade de IA " 使用MarkPDFDown有哪些需要注意的限制和问题？
Português do Brasil 
简体中文 
English 
日本語 
Deutsch