[FR] Page Outline / Table of Contents sidebar for in-page navigation
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 15/100
Research direction
The issue names no files, tests or entry points, so the first step is to find the Flutter editor code that renders document headings and to check with maintainers how a sidebar should fit into the layout. Done would mean a toggleable panel that lists H1-H3 headings with nested indentation, jumps to a section when clicked, and updates while the document is edited. Scroll-based highlighting is optional. Expect this to need design agreement before any code.
Written by the indexing model from the issue text.
Description
Description
I'm requesting a Table of Contents feature similar to Notion's page outline sidebar.
What it does:
- Automatically scans headings (H1, H2, H3) in the current page
- Displays them in a collapsible sidebar on the right
- Clicking any heading scrolls/navigates to that section
- Updates dynamically as I type
Use case:
When working on long pages (thesis notes, project documentation, learning materials), I need quick navigation between sections without scrolling manually. This is essential for deep work sessions where I'm handling multiple complex topics.
Current workaround:
Manually creating links or using search, which breaks flow and adds friction.
Impact
Who benefits:
- Students and researchers writing long-form content
- Developers documenting projects
- Anyone using AppFlowy as a second brain or knowledge base
- Users migrating from Notion who expect this standard feature
Why it matters:
Navigation efficiency directly impacts productivity. For pages with 10+ sections, this feature saves significant time and maintains focus during deep work.
Additional Context
Reference: Notion's Table of Contents block and page outline sidebar.
Technical notes:
- Should parse markdown headings automatically
- Could be a toggleable sidebar (like Notion's
≡button) - Should support nested headings with indentation
- Optional: highlight current section based on scroll position
My setup: Self-hosted AppFlowy via Podman, primarily used for academic research
- Dominant language
- Dart
- Stars
- 79.1k
- Forks
- 6.3k
- Avg merge
- 17h 29m
- Merged PRs (30d)
- 1
Getting set up
- No Dockerfile or Docker Compose file
- Has a pull request template
- No contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from AppFlowy-IO/AppFlowy
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
AppFlowy-IO/AppFlowy#9147 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
AppFlowy-IO/AppFlowy#9118 · 1 reaction ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
AppFlowy-IO/AppFlowy#9094 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
AppFlowy-IO/AppFlowy#9075 · 1 reaction ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 66/100
AppFlowy-IO/AppFlowy#9074 ·
Maintainers usually reply within 1 day
All issues in AppFlowy-IO/AppFlowy
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
Difficulty 1/5 Under an hour Newbie friendliness 62/100
ccch1mneyyy/dsh-Go#1682 ·
Maintainers usually reply within 1 day
-
help wanted
Difficulty 1/5 Under an hour Newbie friendliness 76/100
pesaclarity/ujumbe-parsers#64 ·
Maintainers usually reply within 1 day
-
enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 64/100
patarapolw/lingua_srs#278 ·
Maintainers usually reply within 1 day
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
dreautall/waterfly-iii#890 · 1 comment ·
Maintainers usually reply within 1 day