From 7391bf95ef8c8d52a19d9be9c33cd6445acd60e1 Mon Sep 17 00:00:00 2001
From: yeasy <yangbaohua@gmail.com>
Date: Thu, 23 Jul 2026 22:57:35 -0700
Subject: [PATCH] fix(html-reader): stop pandoc from collapsing bold-lead-in
 lists into a paragraph
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The book style writes a bold label then a list with no blank line between them:

    **触发分离的条件**：
    - 输入序列长度 > 某阈值

Strict CommonMark (pandoc default -f markdown) requires a blank line before a
list, so it folded every such list into a single <p>. Measured 640 occurrences
across 13 books — troubleshooting checklists and diagnostic steps shipped in the
offline HTML reader as run-on paragraphs, while GitBook, GitHub, and the PDF all
rendered them correctly. The source was fine; only this reader was wrong.

Fix is the additive pandoc extension markdown+lists_without_preceding_blankline,
verified on real book content through real pandoc: the three bullets that
previously joined into one <p> now produce <ul><li>, with no effect on ordinary
paragraphs or on tables (pipe_tables stays enabled).
---
 tools/build_html_reader.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tools/build_html_reader.py b/tools/build_html_reader.py
index 5cb4da7..d80a58d 100644
--- a/tools/build_html_reader.py
+++ b/tools/build_html_reader.py
@@ -218,7 +218,7 @@ def main():
     tpl = "/tmp/_book_template.html"; out_tmp = "/tmp/_book_out.html"
     with open(tmp_md, "w", encoding="utf-8") as f: f.write(combined)
     with open(tpl, "w", encoding="utf-8") as f: f.write(TEMPLATE)
-    cmd = ["pandoc", "_combined_tmp.md", "-f", "markdown", "-t", "html5",
+    cmd = ["pandoc", "_combined_tmp.md", "-f", "markdown+lists_without_preceding_blankline", "-t", "html5",
            "--standalone", "--embed-resources", "--mathml",
            "--template", tpl, "--metadata", f"title={a.title}", "-o", out_tmp]
     print("  running pandoc ...")