jongio · jongio · Jul 12, 2026
@@ -185,6 +185,7 @@ Preview panel (panel 5).
 | `j/k` | Scroll content |
 | `g/G` | Jump to top/bottom |
 | `L` | Go to line |
+| `t` | Jump to markdown heading |
 | `PgDn/PgUp` | Page down/up |
 | `W` | Toggle word wrap |
 | `n` | Toggle line numbers |

@@ -161,6 +161,7 @@
         { "key": "j/k", "action": "Scroll content" },
         { "key": "g/G", "action": "Jump to top/bottom" },
         { "key": "L", "action": "Go to line" },
+        { "key": "t", "action": "Jump to markdown heading" },
         { "key": "PgDn/PgUp", "action": "Page down/up" },
         { "key": "W", "action": "Toggle word wrap" },
         { "key": "n", "action": "Toggle line numbers" },

@@ -22,6 +22,8 @@ const (
 	keyDown   = "down"
 	keyEsc    = "esc"
 	keyEscape = "escape"
+	keyEnter  = "enter"
+	keyEnd    = "end"
 
 	// clipboardTimeout bounds how long clipboard subprocess calls may block.
 	clipboardTimeout = 2 * time.Second
@@ -283,7 +285,7 @@ func handleEditKeyPress(p *Preview, msg tea.KeyPressMsg) (panels.Panel, tea.Cmd)
 			ensureCursorVisible(p)
 		}
 
-	case "enter":
+	case keyEnter:
 		if p.editBuf != nil {
 			p.editBuf.SplitLine(p.cursorLine, p.cursorCol, p.editCfg.AutoIndent)
 			p.cursorLine++
@@ -551,7 +553,7 @@ func handleEditKeyPress(p *Preview, msg tea.KeyPressMsg) (panels.Panel, tea.Cmd)
 		clearEditSelection(p)
 		p.cursorCol = 0
 
-	case "end", "ctrl+e": //nolint:goconst // key name, not a magic string
+	case keyEnd, "ctrl+e":
 		clearEditSelection(p)
 		if p.editBuf != nil {
 			line := p.editBuf.Line(p.cursorLine)

@@ -64,6 +64,13 @@ type Preview struct {
 	// as a line-number entry and scrolls to the entered line on Enter.
 	gotoLineActive bool
 	gotoLineInput  string
+	// Markdown heading-jump overlay state. mdHeadings is populated on load for
+	// markdown files; tocTargets holds the resolved display line per heading
+	// while the overlay is open.
+	tocActive  bool
+	tocCursor  int
+	mdHeadings []tocHeading
+	tocTargets []int
 	// GitHub content mode – when a GitHub item (issue/PR/action run) is
 	// selected, the preview shows the item detail instead of a file.
 	ghMode      bool // true when showing GitHub content instead of file
@@ -96,6 +103,7 @@ type fileLoadedMsg struct {
 	err      error
 	path     string
 	lines    []string
+	headings []tocHeading
 	isBinary bool
 	isLarge  bool
 }
@@ -263,6 +271,10 @@ func (p *Preview) Update(msg tea.Msg) (panels.Panel, tea.Cmd) {
 		p.blameMode = false
 		p.blameLines = nil
 		p.diffLines = nil
+		p.tocActive = false
+		p.tocCursor = 0
+		p.mdHeadings = nil
+		p.tocTargets = nil
 		cmds := []tea.Cmd{p.loadFileCmd(msg.Path)}
 		if p.gitClient != nil {
 			cmds = append(cmds, p.loadContextDiffCmd(msg.Path, p.diffContext))
@@ -273,6 +285,7 @@ func (p *Preview) Update(msg tea.Msg) (panels.Panel, tea.Cmd) {
 		if msg.path == p.filePath {
 			p.loading = false
 			p.lines = msg.lines
+			p.mdHeadings = msg.headings
 			p.err = msg.err
 			p.isBinary = msg.isBinary
 			p.isLarge = msg.isLarge
@@ -471,6 +484,10 @@ func (p *Preview) Update(msg tea.Msg) (panels.Panel, tea.Cmd) {
 		if p.gotoLineActive {
 			return p.handleGotoLineKey(msg)
 		}
+		// The heading-jump overlay captures all input while it is open.
+		if p.tocActive {
+			return p.handleTOCKey(msg)
+		}
 		switch msg.String() {
 		case "e":
 			// Edit is only allowed in file mode (not diff) and for local files.
@@ -496,6 +513,8 @@ func (p *Preview) Update(msg tea.Msg) (panels.Panel, tea.Cmd) {
 			p.scrollToBottom()
 		case "L":
 			return p, p.openGotoLine()
+		case "t":
+			return p, p.openTOC()
 		case "W":
 			p.wordWrap = !p.wordWrap
 		case "n":
@@ -561,7 +580,7 @@ func (p *Preview) handleGotoLineKey(msg tea.KeyPressMsg) (panels.Panel, tea.Cmd)
 	switch msg.String() {
 	case keyEscape, keyEsc:
 		return p, p.closeGotoLine()
-	case "enter":
+	case keyEnter:
 		p.commitGotoLine()
 		return p, p.closeGotoLine()
 	case "backspace":
@@ -636,6 +655,10 @@ func (p *Preview) View(width, height int) string {
 	if p.editMode && p.editBuf != nil {
 		return renderEditContent(p, width, height)
 	}
+	// Heading-jump overlay takes over the content area while it is open.
+	if p.tocActive {
+		return p.renderTOC(width, height)
+	}
 	// Blame mode
 	if p.blameMode && len(p.blameLines) > 0 {
 		return p.renderBlameContent(width, height)
@@ -717,6 +740,7 @@ func (p *Preview) KeyBindings() []panels.KeyBinding {
 		{Key: "g", Description: "Go to top", Action: "goto_top"},
 		{Key: "G", Description: "Go to bottom", Action: "goto_bottom"},
 		{Key: "L", Description: "Go to line", Action: "goto_line"},
+		{Key: "t", Description: "Jump to heading", Action: "goto_heading"},
 		{Key: "W", Description: "Toggle word wrap", Action: "toggle_wrap"},
 		{Key: "n", Description: "Toggle line numbers", Action: "toggle_line_numbers"},
 		{Key: "m", Description: "Toggle markdown render", Action: "toggle_markdown_render"},
@@ -794,6 +818,7 @@ func (p *Preview) loadFileCmd(path string) tea.Cmd {
 		// Render based on file type
 		switch ext {
 		case extMD, extMarkdown, extMdown, extMkd:
+			result.headings = parseMarkdownHeadings(source)
 			if renderMD {
 				result.lines = markdown.RenderStatic(source, width)
 			} else if cfg.GetSyntaxHighlighting() {

@@ -778,7 +778,7 @@ func TestKeyBindings(t *testing.T) {
 	bindings := p.KeyBindings()
 
 	assert.NotEmpty(t, bindings)
-	assert.Len(t, bindings, 15)
+	assert.Len(t, bindings, 16)
 
 	// Verify all expected bindings are present
 	actions := make([]string, len(bindings))
@@ -795,6 +795,7 @@ func TestKeyBindings(t *testing.T) {
 	assert.Contains(t, actions, "goto_top")
 	assert.Contains(t, actions, "goto_bottom")
 	assert.Contains(t, actions, "goto_line")
+	assert.Contains(t, actions, "goto_heading")
 	assert.Contains(t, actions, "toggle_wrap")
 	assert.Contains(t, actions, "toggle_line_numbers")
 	assert.Contains(t, actions, "toggle_markdown_render")