企业官网建设流程全解析

长文如何高效导航？leaf 目录侧边栏、全文搜索与跳转行号完整使用教程

【免费下载链接】leafTerminal Markdown previewer — GUI-like experience.项目地址: https://gitcode.com/gh_mirrors/leaf37/leaf

leaf是一款运行在终端里的 Markdown 预览器，提供接近图形界面的阅读体验。面对几十上百屏的长文档，逐屏滚动显然是低效的。本文带你掌握 leaf 的三大导航利器：目录侧边栏、全文搜索与跳转行号，三招组合下来，无论多长的文档都能秒级定位到目标位置。

一键打开目录侧边栏：t键速览文档结构

打开任意 Markdown 文件后，按下t键即可切换目录侧边栏（TOC）。侧边栏会列出文档的标题层级结构，并且：

• 自动规整标题层级：即使你混用了 H1/H2/H3，leaf 也会智能归一化，只保留最重要的 3 个层级，侧边栏不会乱成一团
• 高亮当前章节：滚动到哪一章，侧边栏对应条目就高亮显示，随时知道"我在哪"
• 侧边栏可滚动：标题过多时，用J/K在顶层章节间循环跳转，U/D让侧边栏列表上下翻半页

💡 小技巧：状态栏右侧的百分比（如37%）实时显示你的滚动位置，配合侧边栏高亮，长文档再也不会迷路。

数字键直达章节：1-9快速跳转

leaf 支持用1到9数字键直接跳到对应的顶层章节，这是长文导航最快的操作：

• 按1跳到第 1 章，按5跳到第 5 章
• 同一数字键连续按，会在该章节的下一级标题之间循环切换，方便浏览一章内的所有小节
• 按0切换反向循环，往回翻

相关逻辑实现在 src/app/navigation.rs 中，如果你好奇"循环跳转"是怎么实现的，可以看看cycle_numkey函数。

全文搜索：/键高亮所有匹配项

找不到某个关键词在哪里？按/（或Ctrl+F）进入搜索模式，输入关键词后回车：

• 全文匹配、高亮显示：所有命中行都会高亮，一眼扫完全文分布
• 匹配计数器：状态栏显示3/7这样的进度，当前第 3 处、共 7 处
• n/N前后跳转：n跳下一个匹配，N（Shift+N）跳上一个，到末尾自动循环回开头
• Esc取消搜索：清除高亮，回到正常浏览

搜索不区分大小写（源码见 src/app/search.rs 的run_search），所以输入Leaf和leaf效果相同。

跳转行号：Ctrl+L或:精准定位

当别人告诉你"第 128 行有个重点"时，就是行号跳转的用武之地：

• 按Ctrl+L或:进入跳转模式，状态栏出现:输入框
• 输入行号、按回车，文档直接滚动到该行——leaf 会把目标行放在距顶部 5 行的位置，上下文一目了然（见 src/app/goto_line.rs 中的GOTO_LINE_CONTEXT_OFFSET）
• 跳转模式会自动开启行号显示；平时可单独用Shift+L切换行号显示
• 输入的行号不存在时，状态栏会显示错误提示，按Esc即可取消

基础滚动与鼠标操作：熟悉手感

在掌握上面三大功能之前，先熟悉 leaf 的常规滚动方式（详见 demo/sources/demo-navigation.md）：

三大导航功能速查表

小结：长文档导航的黄金组合

回到文章开头的问题——长文如何高效导航？答案是一套组合拳：

1. 先按t打开目录侧边栏，建立整体认知
2. 用1-9数字键快速切换大章节
3. 记得关键词就用/全文搜索，配合n逐个查看
4. 明确行号时按Ctrl+L一步到位

这些导航功能的完整演示可以在 demo/README.md 中查阅，交互逻辑源码集中在 src/app/ 目录下的navigation.rs、search.rs与goto_line.rs。装上 leaf，长文档阅读从此告别"盲滚"。🚀

【免费下载链接】leafTerminal Markdown previewer — GUI-like experience.项目地址: https://gitcode.com/gh_mirrors/leaf37/leaf