浅谈笔记文档的标题（Title、Headline）与导出的 Word/Docx 文档中样式的映射情况及解决方法

以下仅为浅谈，不是 Feature Request。

以下仅为浅谈，不是 Feature Request。

以下仅为浅谈，不是 Feature Request。

由于历史原因，Html 和 Markdown 呈现强相关状态，遗憾的是最初 Markdown 中并没 h0 即零级标题，或换言之“文档总标题”的概念，较长时间以来，在不涉及大规模文档组织的情形下，一般也鲜有人关注这个问题，或者说，只有在个人知识管理的语境下，出于组织文档体系的目的，单个文档因为需要与其它文档产生关联，这个文档标题和文件名的耦合关系才逐渐呈现出一些一言难尽的态势。

在思源中，文档标题不允许出现半角斜杠符号 “/”，但是它允许出现星号“*”，这是一个很奇怪的设定。我说这一点是因为，在思源中，文档总标题呈现出较强的“文件名属性”，但是它又不是文件名。显然后台是以节点 ID 存储的。这里已经实现了文件名与 Title 的解耦，是个很好的思路，但是不知道为什么不允许使用斜杠符号。当然这个问题不重要。

重要的是在将思源导出为 docx 格式时，pandoc 是可以识别“文档标题(Title)”和其它六个级别标题（Headline1-Headline6）的，但是思源并没有对其进行单独处置区别对待，而是一视同仁地将思源笔记标题映射为 H1，可以想见这是为了照顾导出为 md 的情形，当然这可能是一种主要的场景。毕竟 MD 有天然的不足。

当然有许多规避的方法，例如正文从 H2 开始，以防止出现两个 H1 的尴尬状态，但是导出到 DOCX 时又有问题了。因为，日常写 WORD 文档时，从 H2 开始显然不是一种常规状态，这种导出的从 H2 开始的文档，不符合 WORD 的写作范式。

我看到站里有直接从 SY 文件格式转换为 WORD 的尝试，是一位网友使用 PYTHON 做的 自己做了一款 sy 转 word 的文件。

还有一种思路，是可以写几行脚本，批量处置被导出的 WORD，将它们的第一个 H1 强制转换为 TITLE 样式。

代码实现如下：

先安装依赖包：

pip install python-docx

单个 docx 的处理用这个

# docx_h1_to_title.py
from docx import Document
from docx.shared import Pt, Inches
from docx.enum.text import WD_PARAGRAPH_ALIGNMENT
from docx.enum.style import WD_STYLE_TYPE
from pathlib import Path

def set_first_h1_to_main_title(input_docx, output_docx):
    """
    将Word文档中第一个H1样式的段落修改为“标题”样式
    :param input_docx: 输入Word文件路径（.docx）
    :param output_docx: 输出Word文件路径（.docx）
    """
    # 1. 打开文档
    doc = Document(input_docx)
  
    # 2. 定义“标题”样式（可根据需求调整参数）
    try:
        # 若已存在“标题”样式，直接使用
        main_title_style = doc.styles["标题"]
    except KeyError:
        # 不存在则创建新样式（基于“正文”扩展）
        main_title_style = doc.styles.add_style("总标题", WD_STYLE_TYPE.PARAGRAPH)
        # 设置字体格式
        font = main_title_style.font
        font.name = "微软雅黑"  # 字体
        font.size = Pt(24)      # 字号（24号字，可调整）
        font.bold = True        # 加粗
        font.color.rgb = None   # 黑色（如需其他颜色，设为 RGB(0,0,0) 格式）
        # 设置段落格式
        para_format = main_title_style.paragraph_format
        para_format.alignment = WD_PARAGRAPH_ALIGNMENT.CENTER  # 居中对齐
        para_format.space_after = Pt(20)                       # 段后间距（20磅）
        para_format.left_indent = Inches(0)                    # 左缩进0
        para_format.right_indent = Inches(0)                   # 右缩进0

    # 3. 找到第一个H1样式的段落并替换样式
    h1_found = False
    for para in doc.paragraphs:
        # 判断是否为H1样式（适配中英文Word：中文是“标题 1”，英文是“Heading 1”）
        if para.style.name in ("标题 1", "Heading 1"):
            # 应用“总标题”样式
            para.style = main_title_style
            h1_found = True
            print(f"已将第一个H1段落「{para.text[:20]}...」修改为 “标题” 样式")
            break  # 只修改第一个，找到后退出循环

    if not h1_found:
        print("警告：文档中未找到H1（标题 1/Heading 1）样式的段落")

    # 4. 保存修改后的文档
    doc.save(output_docx)
    print(f"修改完成！文件已保存至：{output_docx}")

# ------------------- 运行脚本 -------------------
if __name__ == "__main__":
    # 请修改以下两个路径（绝对路径或相对路径均可）
    INPUT_FILE = Path(input("输入="))    # 你的原始Word文件
    OUTPUT_FILE = INPUT_FILE.parent/ (INPUT_FILE.stem+'_fixed.docx')  # 修改后的保存路径

    # 执行修改
    set_first_h1_to_main_title(INPUT_FILE, OUTPUT_FILE)

批量处理时用这个。（上面那个需要被下面这个导入）

# batch.py
from docx_h1_to_title import set_first_h1_to_main_title
from pathlib import Path
import os

global WD
WD = Path(input('输入工作目录路径='))
for f in os.listdir(WD):
    if f.endswith('.docx'):
        INPUT_FILE = WD / f
        OUTPUT_FILE = WD / (INPUT_FILE.stem + '_fixed.docx')
        print(f'处理文件: {INPUT_FILE}')
        input('按回车继续...')
        try:
            set_first_h1_to_main_title(INPUT_FILE, OUTPUT_FILE)
        except Exception as e:
            print(f'处理文件 {INPUT_FILE} 时出错: {e}')

不过我仔细想了一下，思源完美导出的话，需要涉及的问题是非常多的，几乎是个无底洞，想想都头大。例如，引用，公式，表格，表题，图片 ALT……我看到 ACHUAN 大佬做了个模板 ，也提到了上述的一些问题点。

从某种意义上讲，思源最大的竞争对手，可能是微软的 Word （笑）。

以上仅为浅谈，不是 Feature Request。

以上仅为浅谈，不是 Feature Request。

以上仅为浅谈，不是 Feature Request。