Jekyll 如何为Markdown文章与Staticman评论配置差异化换行渲染规则

核心约束说明 #

• 文章端保持默认kramdown渲染规则：无空行分隔的连续行包裹在同一个<p>标签内，不自动插入换行标签；空行分隔的内容自动拆分为独立<p>段落
• 评论端适配用户输入习惯：无空行分隔的连续行在每行末尾自动补充<br>标签；空行分隔的内容同样拆分为独立段落
• 不修改全局kramdown配置，避免影响现有文章的排版效果

文章端默认配置（无需额外调整） #

Jekyll原生kramdown的默认渲染规则完全匹配文章端需求，直接保留_config.yml中默认的hard_wrap: false配置即可：

• 针对示例内容"Test\r\nNew line without a gap\r\n\r\nNew line with a gap."，默认输出为：

  <p>Test
  New line without a gap</p>
  <p>New line with a gap.</p>
  

  无多余换行标签，段落拆分准确。

评论端渲染逻辑修正 #

原有newline_to_br直接接markdownify的实现存在多余<br>的问题，根源是newline_to_br会把段落之间的分隔换行也转换为<br>标签，后续markdownify处理时会在段落前后留下冗余标签。
替换原有评论模板的渲染逻辑为以下原生Liquid实现，无需额外安装插件：

{% assign comment_safe = include.message | strip_html %}
{% comment %} 按连续空行拆分独立段落块 {% endcomment %}
{% assign para_blocks = comment_safe | split: "

" %}
{% assign processed_comment = "" %}
{% for block in para_blocks %}
  {% comment %} 单个段落块内部的单换行替换为<br> {% endcomment %}
  {% assign block = block | strip | replace: "
", "<br>" %}
  {% assign processed_comment = processed_comment | append: block | append: "

" %}
{% endfor %}
{% comment %} 最后通过markdownify生成安全的渲染输出 {% endcomment %}
{{ processed_comment | markdownify }}

以上逻辑的输出效果对应用例输入：

<p>Test<br>New line without a gap</p>
<p>New line with a gap.</p>

完全符合评论端的渲染要求，无冗余<br>标签，段落拆分准确。

落地校验要点 #

• 不要全局开启hard_wrap: true，否则文章端的连续行会被强制插入<br>，破坏原有排版
• 保留strip_html步骤，过滤用户输入的恶意HTML标签，保障站点安全
• 逻辑兼容Staticman返回的JSON评论数据结构，无需调整Staticman的webhook配置

内容的提问来源于stack exchange，提问作者dmkr