骡子快跑未自动生成目录是因标题格式不规范、toc功能未启用、缺少[toc]标记、文档格式不兼容或编码含bom所致；需统一用#语法、开启auto toc并设层级、插入[toc]、转纯md格式、改utf-8无bom。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您使用骡子快跑处理长文档，但发现其未自动生成目录结构，则可能是由于文档内标题层级未被正确识别或格式不满足解析条件。以下是实现长文档结构自动创建的多种方法：
一、确保文档使用标准Markdown标题语法
骡子快跑依赖标题标记（如#、##、###）识别层级关系并构建目录。若文档中混用空格缩进、特殊符号或非标准换行，将导致解析失败。
1、检查文档中所有标题是否以井号开头，且井号后紧跟一个空格，例如：# 一级标题，而非“#一级标题”或“# 一级标题”。
2、确认各级标题严格遵循递进规则：二级标题（##）必须出现在一级标题之后，不可在文档开头直接使用###而无前置##或#。
3、删除标题行末尾的全角空格、不可见Unicode字符（如U+200B零宽空格），可粘贴至纯文本编辑器中重新输入标题行。
二、启用骡子快跑的TOC生成开关并指定深度
部分版本默认关闭自动目录生成功能，或仅扫描前两级标题；需手动激活并设定最大层级，才能覆盖长文档的完整结构。
1、打开骡子快跑设置界面，定位到“文档处理”或“输出选项”标签页。
2、找到名为“生成目录”或“Auto TOC”的复选框，将其勾选为启用状态。
3、在相邻的“最大标题层级”输入框中，填入数字4或5，确保涵盖文档中实际使用的最高级标题（如####或#####）。
三、插入显式TOC标记并刷新解析
当自动识别不稳定时，可在文档起始位置插入专用指令标记，强制骡子快跑在此处注入目录内容，并基于后续标题实时更新结构。
1、在文档最上方第一行，单独输入一行：[toc]，前后不加空行或空格。
2、保存文档后，在骡子快跑中执行“重新加载”或“刷新结构”操作（通常位于右键菜单或工具栏刷新图标）。
3、观察界面右侧或顶部是否出现可折叠的层级目录面板；若未出现，检查该行是否被误置于代码块、引用块或列表项内部。
四、转换为兼容性更强的文档格式再导入
骡子快跑对原生Markdown支持最佳，若原始文档来自Word、Notion或Typora等工具，可能携带富文本残留，干扰标题提取。
1、将原文档另存为纯Markdown（.md）格式，避免使用.docx或.html直接导入。
2、若原文档含复杂样式，先用Pandoc命令行执行：pandoc input.docx -t markdown -o output.md，清除格式杂质。
3、用文本编辑器打开output.md，人工验证前10个标题是否符合#语法规范，再将该文件拖入骡子快跑窗口。
五、检查文档编码与BOM头是否匹配
UTF-8 with BOM格式可能导致骡子快跑读取首行失败，使[toc]标记或首个#标题无法被识别，进而跳过整个目录构建流程。
1、用VS Code或Notepad++打开文档，点击右下角编码显示区域，确认当前为UTF-8而非UTF-8 with BOM。
2、若显示含BOM，选择“编码 → 转为UTF-8”，保存后关闭并重新打开文件。
3、检查文档首字符是否为可见内容，而非隐藏BOM字节（如打开后首行看似空白但光标无法左移至行首最左侧）。
