如何解决Moffee使用过程中的常见报错？

2025-08-29

1.3 K

故障排查手册

针对典型问题的解决方案：

ブート失敗::
1. 确认Python版本：python3 -V需≥3.10
2. 检查依赖：pip list | grep moffee
3. 清除缓存：pip cache purge
渲染异常::
1. 验证Markdown语法：在线工具检查格式
2. 禁用扩展：尝试moffee make --no-extras
3. ログを見るmoffee debug yourfile.md
导出问题::
1. HTML乱码：添加charset: utf-8到front matter
2. PDF缺失内容：改用moffee make --pdf专有命令

进阶调试：启用详细日志moffee yourfile.md -v DEBUG