Opublikowano marzec 2026

Automatyczny spis treści dla Markdown

Długie pliki Markdown potrzebują nawigacji. Spis treści generowany z nagłówków sprawia, że każdy dokument jest łatwy do przeskanowania. ShowMeMyMD generuje go automatycznie — bez tagów, bez wtyczek, bez narzędzi CLI.

## Problem

Markdown nie ma wbudowanego spisu treści

Markdown nie ma składni spisu treści. Nie ma tagu [TOC] w specyfikacji. Niektóre narzędzia go obsługują, większość nie.

Więc ludzie to obchodzą. Generatory CLI jak markdown-toc i doctoc wstrzykują spis treści Markdown do pliku. VS Code ma do tego rozszerzenia. GitHub automatycznie generuje spis dla plików README w wersji webowej.

Nic z tego nie jest automatyczne. Albo modyfikujesz swój plik, albo instalujesz narzędzia. A gdy zmienisz nagłówek, spis jest nieaktualny, dopóki czegoś nie uruchomisz ponownie.

## Jak ShowMeMyMD to rozwiązuje

Otwórz plik. Spis treści już tam jest.

Otwórz dowolny plik .md z nagłówkami — # do ###### — a ShowMeMyMD automatycznie generuje klikalny spis treści.

Bez tagów do wstawiania. Bez wtyczek do instalacji. Bez narzędzi CLI do uruchamiania. Bez konfiguracji. Wystarczy otworzyć plik i nawigować.

Kluczowy szczegół

Spis treści jest generowany w momencie renderowania. Twój plik .md nigdy nie jest modyfikowany. Zmień nagłówek, a spis zaktualizuje się natychmiast przy następnym otwarciu pliku.

## Dlaczego to ważne

Długie dokumenty potrzebują nawigacji

Każdy dokument ze strukturą korzysta z klikalnego spisu treści. Skacz do potrzebnej sekcji zamiast przewijać setki linii.

Pliki README

Projekty open-source z sekcjami instalacji, użycia, dokumentacji API i kontrybucji. Skacz prosto do tego, czego potrzebujesz.

Dokumentacja

Specyfikacje techniczne, referencje API, runbooki. Spis treści zamienia ścianę tekstu w nawigowalne źródło.

Notatki ze spotkań

Punkty agendy, decyzje, elementy do działania. Znajdź decyzję z poprzedniego tygodnia bez ponownego czytania całego dokumentu.

Specyfikacje techniczne

Decyzje architektoniczne, dokumenty projektowe, RFC. Nawiguj złożone dokumenty po sekcjach.

## Alternatywy

Inne sposoby na spis treści Markdown

Ręczny spis treści

Pisz linki Markdown do kotwic nagłówków ręcznie. Coś jak [Instalacja](#instalacja) dla każdej sekcji. Żmudne do pisania, psuje się gdy nagłówki się zmieniają i musisz to utrzymywać sam.

markdown-toc (npm)

Narzędzie CLI, które generuje spis treści i wstawia go jako tekst Markdown do pliku. Działa, ale wymaga Node.js, npm install i ponownego uruchomienia polecenia za każdym razem, gdy nagłówki się zmieniają. Modyfikuje plik źródłowy.

Rozszerzenia VS Code

Kilka rozszerzeń VS Code dodaje generowanie spisu treści. Działają w VS Code, ale potrzebujesz otwartego VS Code — pełne IDE tylko po to, żeby nawigować dokument.

GitHub

GitHub automatycznie generuje spis treści dla plików README w wersji webowej. Kliknij ikonę hamburgera obok nazwy pliku. Ale to działa tylko na GitHub.com — nie dla lokalnych plików na Twoim Macu.

## Prosty sposób

Po prostu otwórz plik

ShowMeMyMD generuje spis treści z Twoich nagłówków automatycznie. Bez modyfikacji plików. Niedestrukcyjnie. Działa z dowolną strukturą nagłówków od # do ######.

Spis treści jest zawsze aktualny, ponieważ jest generowany z pliku w jego obecnym stanie — nie z zbuforowanej migawki czy wstrzykniętego bloku, który może być nieaktualny.

## Czytaj dalej

Przestań przewijać. Zacznij nawigować.

$2.99. Jednorazowy zakup. Bez subskrypcji. Bez konta.

Pobierz zMac App Store