markdown-navigation

Generate hierarchical outlines and extract sections from markdown files using bash utilities.

130|8|Updated Jan 23, 2026
One-click install
npx skills add https://github.com/sandgardenhq/sgai --skill markdown-navigation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-navigation
Source: https://github.com/sandgardenhq/sgai/tree/main/cmd/sgai/skel/.sgai/skills/markdown-navigation
Command: npx skills add https://github.com/sandgardenhq/sgai --skill markdown-navigation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When working with large markdown documents, finding the right section or understanding the document's structure requires scrolling through the whole file, which is time‑consuming and error‑prone.

Core Features & Use Cases

  • Hierarchical Outline: Quickly generate a tree view of all headings in a markdown file.
  • Section Extraction: Retrieve the full content of a specified section without manual searching.
  • Use Case: Ideal for navigating extensive documentation, changelogs, or README files where pinpointing information manually is inefficient.

Quick Start

Run the markdown-viewer.sh script with the target file and optionally a section name to get an outline or extract that section.

Frequently Asked Questions about markdown-navigation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract a specific section from a large markdown file?

To extract a specific section from a large markdown file, run a bash script with the target file and section name. It retrieves the full content of that specified heading block without requiring manual scrolling or external libraries.

Can I generate a hierarchical outline of markdown headings using bash?

Yes, you can generate a hierarchical outline of markdown headings using standard bash utilities like grep and sed. The script produces a tree view of all headings, helping you quickly understand the structure of extensive documentation or README files.

Do I need to install external libraries to navigate markdown files in the CLI?

No external libraries are needed to navigate markdown files in the CLI. The tool leverages standard bash utilities like grep, sed, and wc, ensuring you can extract sections and generate outlines immediately without additional dependencies.

What is the best way to navigate extensive README files without scrolling?

The best way to navigate extensive README files without scrolling is using a CLI tool that generates hierarchical outlines and extracts specific sections. This avoids time-consuming manual searching through large documentation or changelogs.

Are there limitations when extracting sections from markdown changelogs with standard utilities?

When extracting sections from markdown changelogs with standard utilities, the tool relies on consistent heading formatting. Irregular heading levels or malformed markdown structures may affect the accuracy of the hierarchical outline and section extraction.