Marp CLI日志静默处理技巧

在使用Marp CLI进行Markdown转幻灯片时，默认会输出信息日志到标准错误流(stderr)。这些日志虽然对调试有帮助，但在某些自动化场景下可能造成干扰。本文将介绍几种实用的日志静默处理方法。

日志输出机制解析

Marp CLI的设计遵循了Unix哲学，采用分离的输出通道：

• 转换结果输出到标准输出(stdout)
• 所有日志信息(包括INFO和ERROR级别)都输出到标准错误(stderr)

这种设计特别适合管道操作，当使用-o -参数将转换结果输出到stdout时，可以确保日志信息不会污染输出内容。

完全静默模式

如果需要完全屏蔽所有日志输出(包括错误信息)，可以使用Unix的重定向功能：

marp input.md 2>/dev/null

这条命令将stderr重定向到空设备，实现完全静默。但请注意，这样做也会屏蔽错误信息，不利于问题排查。

选择性静默方案

更推荐的做法是只屏蔽INFO日志而保留ERROR日志，这可以通过结合重定向和grep实现：

marp input.md 2> >(grep -Fv '[  INFO ]')

这个命令的工作原理：

1. 将stderr重定向到一个子进程
2. 使用grep过滤掉包含[ INFO ]的行
3. 其他日志(包括错误)会正常显示

进阶技巧

对于更复杂的日志处理需求，可以考虑：

1. 将日志输出到文件：

marp input.md 2> marp.log

2. 使用更精细的日志过滤：

marp input.md 2> >(grep -vE 'INFO|WARN')

3. 结合tee命令同时查看和处理日志：

marp input.md 2> >(tee marp.log | grep -Fv '[  INFO ]')

最佳实践建议

1. 在自动化脚本中建议保留错误日志
2. 开发调试时不要静默日志
3. 考虑使用日志级别环境变量(如果Marp未来支持)
4. 对于复杂项目，建议将日志重定向到文件进行持久化

通过合理运用这些技巧，可以灵活控制Marp CLI的日志输出，既保持生产环境的整洁，又不失调试的便利性。