Asciidoctor预处理中空行对ifdef条件块的影响解析

在Asciidoctor文档处理过程中，条件预处理指令ifdef的行为存在一个值得注意的边界情况。当条件不满足时，块内的空行会意外影响最终的段落划分，这与大多数用户的直觉预期不符。

问题现象

在标准情况下，未定义的ifdef块会被完全移除：

Foo.
ifdef::bar[]
内容
endif::[]
Bar.

输出结果为连续的"Foo. Bar."，所有条件块内的内容都被正确过滤。

但当条件块内包含空行时：

Foo.
ifdef::bar[]

endif::[]
Bar.

输出会意外变成两个独立段落："Foo."和"Bar."，中间出现段落分隔。

技术原理

这个问题源于Asciidoctor预处理器的优化实现。在解析阶段，处理器会：

1. 首先处理条件指令，移除不满足条件的整个块
2. 然后进行段落划分（paragraph parsing）

在优化实现中，空行被特殊处理为段落分隔标记。当空行出现在被移除的条件块内时，预处理阶段未能正确清除这些段落分隔标记，导致最终文档结构出现意外分段。

影响范围

该行为会影响：

• 所有使用ifdef/ifndef条件块的文档
• 条件块内包含空行的情况
• 特别是当条件块位于连续段落中间时

解决方案

临时解决方案是在空行位置插入伪内容：

Foo.
ifdef::bar[]
{empty}
endif::[]
Bar.

永久解决方案需要修改预处理器的空行处理逻辑，确保：

1. 在条件过滤阶段完全清除所有空白行
2. 保持条件块移除后文档结构的连贯性

最佳实践

编写条件块时建议：

1. 避免在条件块内使用纯空行
2. 如需视觉分隔，使用明确的注释标记
3. 复杂条件逻辑考虑使用include指令分离文件

该问题已在2.0.23版本中修复，升级后即可获得符合预期的处理行为。对于需要保持向后兼容的场景，可采用上述临时解决方案。