version: "1.0.1" name: large-file-toc description: Generate table of contents overview for large files. When onboarded Markdown file exceeds threshold (default 30KB), extract heading structure to create navigation file. Trigger condition: Markdown file size >= 30KB.
Large File Table of Contents Overview Generation
Generate table of contents overview for large Markdown files for quick user navigation.
Applicable Conditions
- Markdown file size >= 30KB
- Automatically triggered at onboarding stage 5 (write and update)
Quick Workflow
- Extract headings: Use Grep to search
^#+\s+.*$ - Generate overview: Create
contents_overview/{filename}_overview.md - Update README: Record overview file path
Grep Extract Headings
bash
grep -n '^#' knowledge_base/path/to/file.md
Output example:
10:# Chapter 1 Introduction
150:## 1.1 Background
180:## 1.2 Objectives
400:# Chapter 2 Methodology
Table of Contents Overview Format
See TOC_TEMPLATE.md
README Update Format
markdown
-[filename.md](path/to/file.md) (XXX KB) - Brief description [Table of Contents](contents_overview/filename_overview.md)