Softonic

Markdown-formaterare

Steg 1 / 2
Nästa

Klistra in ett Markdown-dokument så skriver formateraren om det till en konsekvent stil: fixar hopp i rubriknivåer (ingen H2 efter H4), fyller ut tabellkolumner så att de linjeras i källan, framtvingar en enda tom rad mellan block, normaliserar listmarkörer till -, kollapsar serier av tomma rader och sorterar referenslänkdefinitioner längst ner. Den renderade HTML:en ändras inte, bara källfilen blir snyggare, så diffar blir läsbara.

Så skriver formateraren om Markdown

  1. 1

    Klistra in Markdown

    Släpp det råa dokumentet: README, dokumentationssida, mötesanteckningar.

  2. 2

    Välj stilalternativ

    Listmarkör (`-`/`*`), rubrikstil (ATX/Setext), tabelljustering, ombrytningskolumn.

  3. 3

    Formatera

    Verktyget tolkar dokumentet till en AST och omserialiserar det med den valda stilen.

  4. 4

    Diffa utdatan

    En vy sida vid sida visar vad som ändrades innan du klistrar tillbaka det.

Vad formateraren fixar

  • Listmarkörer. *, -, + normaliseras alla till ett konsekvent tecken (standard -).
  • Rubrikhierarki. Varnar (eller befordrar) när H2 följs av H4 utan H3 emellan.
  • Tomma rader. Exakt en tom rad mellan block; inga serier av tre eller fler.
  • Tabeller. Fyller ut varje kolumn så att rören linjeras i källan, även om Markdown-renderare inte bryr sig.
  • Avslutande blanksteg. Skalar bort avslutande mellanslag på varje rad utom den avsiktliga tvåmellanslagsmarkören för radbrytning.
  • Referenslänkar. Samlar [label]: url-definitioner i slutet av dokumentet, sorterade alfabetiskt.
  • Kodstaket. Språktaggen normaliseras till gemener; indragningsbaserade kodblock blir staketblock.

Stilalternativ du kan ställa in

Alternativ Standard Alternativ
Listmarkör - *, +
Rubrikstil ATX Setext för H1/H2
Betoningsavgränsare * _
Fetavgränsare ** __
Ombrytningskolumn 0 (av) 80, 100, 120
Sortera referenslänkar på av

Varför konsekvent Markdown spelar roll

I ett team-repo producerar inkonsekvent Markdown stökiga diffar: varje gång någon sparar en fil med en annan redigerare byter listmarkörer och tabeller flyter om. En formaterare framtvingar en stil så att granskare av pull requests bara ser innehållsändringar. Tänk på det som prettier för prosa.

När du inte ska formatera

  • Staketkodblock förblir byte-för-byte intakta, formateraren rör aldrig innehållet i ett kodblock. Om formatering ändrar kod är det en bugg.
  • Avsiktliga hårda ombrytningar vid smala bredder (readme.md i ett terminalprojekt) bryts om igen om du aktiverar ombrytningskolumnen. Inaktivera ombrytning om du behåller handjusterade radbrytningar.
  • Inbäddade HTML-block passerar oförändrade.

Direktersättningar

Om du föredrar en lokal CLI använder formateraren samma AST-regler som remark-stringify med insticksprogrammet remark-gfm. prettier --parser markdown ger ett liknande resultat.

Vanliga frågor

Nej. Formateraren skriver bara om källan, den renderade HTML-utdatan för både före och efter bör vara likvärdig. Om du ser en renderingsändring, rapportera den som en bugg.

Nej. YAML- eller TOML-front matter högst upp i filen identifieras och passerar orörd.

Ja, sätt ombrytningskolumnen till 80, 100 eller 120 så bryts stycken om. Rader inuti kodstaket rörs aldrig.

Nej. Formateraren antar att dina länkar fungerar; den omorganiserar bara referenslänkdefinitioner. Använd ett länkkontrollverktyg separat.

Nej. Tolkning och formatering körs i din webbläsare; innehållet lämnar aldrig din enhet.

Relaterade verktyg

Webpack-konfigurationsgenerator

Skapa en webpack.config.js för webpack 5 med vanlig JavaScript, React eller Vue: TypeScript, Babel, CSS eller Sass, bilder, HtmlWebpackPlugin, en utvecklingsserver och raden för npm install.

Protocol Buffers-avkodare

Avkoda Protobuf-byte lokalt från hex, Base64, Base64URL, text eller fil, granska fälttolkningar och exportera en privat rapport.

XSD-validerare

Validera ett XML-dokument mot ett XSD-schema och rapportera element- och typavvikelser med exakta radnummer.

YAML till JSON

Omvandla YAML-konfiguration till JSON för verktyg och API:er som bara accepterar JSON. Hanterar ankare, merge-nycklar och nästlade strukturer.

XML-formaterare

Snygga till XML-dokument med konsekvent indrag och fånga formfel med exakta radnummer.

Generator för platshållarbilder

Skapa en bild på 1–4000 px med egna färger och text, ladda ned PNG eller kopiera webbadress och HTML.

Verktyget finns på andra språk