Preskočiť na obsah

Markdown linter

Vyhľadajte prerušené odkazy, chýbajúce úrovne nadpisov a nezavreté kódové bloky v Markdown.

Vstup
Existujúce cesty súborov (jeden na riadok, voliteľne)
Výstup

Markdown linter

Vložte dokument Markdown a tento nástroj bude hlásať, čo s ním nie je v poriadku, jeden výsledok na riadok, s presným číslom riadka. Vždy kontroluje nezhodu značiek **bold**, __bold__, ~~strikethrough~~ a `code`, nevyvážené zátvorky [ ] a prázdne ciele odkazov či obrázkov, úrovne nadpisov, ktoré preskakujú úroveň (H1 priamo nasledovaný H3), a fenced kódové bloky, ktoré sú otvorené, ale nikdy zatvorené — druh chyby syntaxe, ktorá sa môže vykresliť správne v jednom Markdown engine a zlomí sa v inom.

Možnosti pridávajú kontroly, ktoré sú skôr o konzistentnosti ako o syntaxi. Zapnite kontrolu referencií odkazov, aby ste zachytili odkaz [text][ref] bez zodpovedajúcej definície [ref]: url nižšie, a definície, ktoré sú definované, ale nikdy nepoužívané. Kontrola duplicitných nadpisov označí opakovaný text nadpisu a viac ako jeden nadpis prvej úrovne, čo mate čitateľov aj generátory obsahu. Kontrola konzistentnosti zoznamov zachytí zoznam s odrážkami, ktorý sa prepína z - na * v polovici, alebo očíslované položky, ktoré padajú zo sekvencie. Môžete tiež vyžadovať jazyk na každom fenced kódovom bloku, označiť biele znaky na konci riadka (běh presne dvoch medzier je ponechaný, pretože to je zámerný Markdown zlom riadka) a obmedziť dĺžku riadka. Vložte zoznam existujúcich ciest súborov do druhého poľa a lokálne ciele odkazov a obrázkov sa skontrolujú, takže prevedený alebo odstránený súbor sa objaví ako prerušený odkaz pred publikovaním.

Linter spracováva Windows (CRLF) a Unix (LF) konce riadkov rovnakým spôsobom, a kontroly, ktoré by zlyhali na obsahu kódu — značky, odkazy, nadpisy, zoznamy, biele znaky na konci riadka — sa preskakujú pre text vo vnútri fenced kódového bloku. Kontrola dĺžky riadka sa stále uplatňuje všade. Panel výstupu zvýraznuje každý riadok výsledku červenou farbou, takže sa dlhá správa ľahko prezeráva, a počet výsledkov nad ňou zobrazuje skontrolované riadky, nájdené problémy a počítané nadpisy.

Všetko bežalo lokálne vo vašom prehliadači. Dokument, ktorý vložíte, a všetky cesty súborov, ktoré pridáte pre kontrolu odkazov, sa nikdy nikam nenahrávajú. Keď skončíte, skopírujte správu, stiahnite si ju ako súbor .txt, alebo ju odošlite do vstupu ďalšieho nástroja, aby ste mohli pokračovať v práci.

Časté otázky

Parseľuje úplne Markdown ako by to urobil renderer?
Nie. Je to kontroler na základe riadkov postavený na detekciu bežných chýb — nezhodu značiek, prerušené odkazy, chýbajúce úrovne nadpisov, nezavreté fenced kódové bloky — nie úplný CommonMark parser, takže neobvyklá konštrukcia sa môže občas preskočiť alebo príliš označiť.
Prečo nie je běh dvoch medzier na konci neoznačený?
Dva biele znaky na konci riadka sú štandardná syntaxe Markdown na pevný zlom riadka, takže sú ponechané. Jeden bielý znak na konci riadka alebo tabulátor na konci je označený, pretože sú to takmer vždy nehody.
Čo sa počítá ako duplicitný nadpis?
Text nadpisu sa porovnáva bez rozlišovania veľkých a malých písmen po odseknutí, takže "Setup" a "setup" sa považujú za rovnaký nadpis.
Ako skontroluje linky oproti skutočným súborom v mojom projekte?
Vložte jednu relatívnu cestu na riadok do druhého poľa — rovnakí cestu ako vaše odkazy, napríklad docs/setup.md. Miestne ciele odkazov a obrázkov, ktorí nie sú v zozname, sú označení; vonkajšie adresy URL a #anchors sú vždy preskočeni.
Je môj dokument nahrán niekde?
Nie. Kontrola prebieha úplne vo vašom prehliadači — váš Markdown a všetky cesty súborov, ktoré zadáte, zostanú na vašom zariadení.