Narzędzie do naprawy Markdown
Automatycznie napraw uszkodzony Markdown
Co to jest narzędzie do naprawy Markdown?
Nagłówek bez pustej linii nad nim. Blok kodu, który nigdy się nie zamknął. Lista numerowana, która w połowie wraca do 1. Jeśli pisałeś README w zeszłym tygodniu, trafiłeś na co najmniej jeden z tych problemów. To narzędzie przechodzi przez dokument, znajduje problemy strukturalne i przepisuje je tak, by renderer po cichu nie zniszczył twojego wyjścia. Wklej uszkodzony Markdown po lewej, a po prawej dostajesz czystą wersję — słowa pozostają nietknięte, naprawia się tylko rusztowanie wokół nich.
Narzędzie przestrzega specyfikacji CommonMark dla podstawowej gramatyki i zachowuje rozszerzenia GitHub Flavored Markdown — tabele, listy zadań i przekreślenie przetrwają tę podróż. Stosowane reguły są bardzo zbliżone do tych z markdownlint.
Wszystko działa w przeglądarce — twój tekst nigdy nie opuszcza komputera. Napraw Markdown w sekundy i wróć do pracy.
Jak używać narzędzia do naprawy Markdown
Trzy kroki. Każdy używa rzeczywistych przycisków na tej stronie.
Wklej uszkodzony Markdown lub załaduj przykład
Wklej Markdown do lewego edytora. Kliknij Przykładowy Markdown, aby załadować przykład z typowymi awariami — brakująca pusta linia przed H2, niezamknięty fence ```js, restartująca się lista numerowana.
# Order Processing
```python
def process(order):
| Stage | Owner |
|-------|-------
[doc][missing-refNarzędzie poprawia odstępy pustych linii, zamyka wiszące bloki kodu, normalizuje wcięcia list i równoważy znaczniki podkreślenia zgodnie z CommonMark.
Kliknij Napraw Markdown!!
Kliknij zielony przycisk Napraw Markdown!! na pasku narzędzi. Narzędzie analizuje dokument i przepisuje problemy strukturalne. Podczas przetwarzania pojawia się wskaźnik ładowania.
Przejrzyj naprawione wyjście
Prawy panel pokazuje czysty Markdown. Twoja proza, nagłówki, próbki kodu — wszystko bez zmian. Tylko odstępy, fence’y i wcięcia są przepisywane.
Kiedy naprawdę tego używasz
Czyszczenie README
Przepuść README projektu przez narzędzie naprawcze przed commitem. GitHub renderuje Markdown surowo, a pojedynczy niezamknięty fence może połknąć połowę pliku.
Czyszczenie wklejonej zawartości
Kopiowanie z Notion, Confluence lub czatu do pliku Markdown często zostawia popsute punkty list i dziwne spacje. Narzędzie spłaszcza to z powrotem do czystego CommonMark.
Generatory stron statycznych
Hugo, Jekyll, Astro, MkDocs — wszystkie krztuszą się tymi samymi błędami strukturalnymi. Napraw źródło raz i twój pipeline buildowy przestaje narzekać.
Czyszczenie Markdown wygenerowanego przez AI
LLM-y uwielbiają zapominać o zamykającym ``` lub przeskakiwać z H2 do H4. Narzędzie normalizuje hierarchię nagłówków i równoważy fence’y.
Często zadawane pytania
Czy mój Markdown jest przechowywany?
Nie. Narzędzie działa w całości w przeglądarce — bez ruchu serwerowego. Tekst nigdy nie opuszcza karty.
Jakie problemy faktycznie naprawia?
Brakujące puste linie wokół nagłówków i list, niezamknięte bloki kodu, mieszane znaczniki w jednej liście, przerwane sekwencje numeracji, niezrównoważone podkreślenia, linki referencyjne do niezdefiniowanych etykiet i wiersze tabel z błędną liczbą pipe’ów.
Czy zmieni moje słowa?
Nie. Narzędzie dotyka tylko strukturalnych białych znaków, znaczników fence, punktorów list i składni linków. Treść akapitów, nagłówków i bloków kodu pozostaje dokładnie taka sama.
CommonMark czy GitHub Flavored Markdown?
Oba. Podstawowa gramatyka jest zgodna z CommonMark; rozszerzenia GFM (tabele, listy zadań, autolinki, przekreślenie) są zachowywane bez zmian.
Czy mogę używać dla dużych plików Markdown?
Do 64 KB — to obejmuje większość README i wpisów blogowych. Dla 200-stronicowego podręcznika podziel na rozdziały.
Czy naprawiony Markdown jest zawsze prawidłowy?
Dla typowych awarii — tak. Dla nietypowych przypadków zwaliduj naszym Walidatorem Markdown.
Inne narzędzia Markdown, których możesz potrzebować
Naprawa to tylko jeden krok w przepływie pracy. Oto narzędzia, które zazwyczaj idą dalej: