Presenterm 项目中的标题居中显示问题分析与修复

在终端演示工具 Presenterm 中，开发者发现了一个关于 Markdown 标题居中对齐的微妙但重要的问题。本文将深入分析该问题的成因、影响范围以及最终的解决方案。

问题现象

当使用 Presenterm 渲染 Markdown 文档时，用户观察到以下不一致现象：

1. 常规的 # 标题 格式的标题在居中对齐时，会向右偏移约半个字符宽度
2. 相同内容使用 Setext 风格（下划线）的标题则能完美居中
3. 普通正文文本的居中对齐也没有问题

这种差异在视觉上虽然细微，但对于追求完美演示效果的用户来说却十分明显。

技术分析

经过代码审查，发现问题根源在于标题前缀字符的处理逻辑：

1. Presenterm 支持通过主题配置自定义标题前缀（如 #）
2. 即使用户将前缀设置为空字符串 ""，渲染引擎仍会为前缀保留空间
3. 这种保留导致了计算居中位置时的偏差
4. 只有当前缀显式设置为 null 时，引擎才会完全忽略前缀空间

解决方案

修复方案包含以下关键点：

1. 修改渲染逻辑，使空字符串 "" 和 null 具有相同效果
2. 确保在计算文本宽度时，完全忽略被移除的前缀
3. 保持与现有主题配置的向后兼容性

用户配置建议

对于需要完美居中对齐的用户，推荐以下配置方式：

headings:
  h1:
    prefix: null
    alignment: center

需要注意的是，如果用户扩展了内置主题，必须确保自定义配置完全覆盖父主题的相关设置，否则可能会继承不期望的样式。

总结

这个案例展示了终端文本渲染中字符级精度的挑战。Presenterm 通过这次修复，实现了各类标题对齐方式的一致性，为追求完美演示效果的用户提供了更好的体验。这也提醒我们，在文本处理系统中，即使是不可见的字符或空间，也可能对最终布局产生微妙但重要的影响。