Radbrytningar i Markdown: nya rader, stycken och tabellceller
Lägg till en ny rad i Markdown med ett omvänt snedstreck, två blanksteg eller en tom rad. Rätta brytningar i README, listor och tabellceller före Word-export.
För att börja på en ny rad inom ett Markdown-stycke sätter du ett omvänt snedstreck i slutet av den första raden och trycker sedan på Enter. För att börja ett separat stycke lämnar du en tom rad. Det skapar olika dokumentstrukturer, vilket spelar roll när du senare exporterar en README-fil, en adress eller en rapport till Word.
Dokumentationsteamet\
Exempelgatan 42\
Portland, Oregon
Adressen förblir ett enda stycke som visas på tre rader. Klistra in den i Markdown-förhandsvisningen för att jämföra med exemplen nedan.
Välj den typ av brytning du behöver
| Önskat resultat | Markdown-källtext | Typisk användning |
|---|---|---|
| Fortsätt samma stycke | En vanlig ny rad | Dela upp långa källtextrader |
| Börja en annan rad i samma stycke | Omvänt snedstreck följt av Enter | Adresser och korta verser |
| Börja ett nytt stycke | En tom rad | Skilja tankar åt i en artikel |
| Bryt inom en tabellcell | <br> där HTML stöds | Två korta etiketter i en cell |
En radbrytning skapar ingen sidbrytning. Om nästa avsnitt behöver ett nytt ark i ett exporterat dokument, se den separata guiden till sidbrytningar i Markdown.
Varför Enter kan se ut som ett blanksteg
Prova den här källtexten:
Utkastet är klart.
Granskaren kan öppna det i dag.
I webbplatsens förhandsvisning tillhör båda meningarna samma stycke och flyter samman. Radbytet är fortfarande användbart i källfilen, men tvingar inte webbläsaren att börja en ny visad rad. Webbläsaren kan fortfarande radbryta texten efter den tillgängliga bredden.
Lägg nu in en tom rad:
Utkastet är klart.
Granskaren kan öppna det i dag.
Förhandsvisningen skapar två stycken. Använd den här versionen när den andra meningen inleder en ny tanke. Flera tomma rader är inget tillförlitligt sätt att begära extra vertikalt avstånd; styckenas utformning hör till renderaren eller dokumentmallen.
Omvänt snedstreck eller två avslutande blanksteg
CommonMark definierar två blanksteg före ett radbyte och ett omvänt snedstreck före ett radbyte som syntax för en hård radbrytning inom ett stycke. CommonMarks exempel på hårda radbrytningar dokumenterar båda formerna.
Versionen med omvänt snedstreck syns tydligt när du granskar en fil:
Förberett av dokumentationsteamet\
Granskat av den releaseansvariga
Alternativet är att skriva exakt två blanksteg efter dokumentationsteamet och sedan trycka på Enter. Blankstegen är osynliga i många redigerare och kan tas bort av automatisk rensning av avslutande blanktecken. Om en brytning försvinner efter att du sparat, kontrollera inställningarna för blanktecken eller använd omvänt snedstreck.
Skriv inte de två tecknen \n i vanlig löptext och förvänta dig en brytning. Det är en konvention för strängar i programmering, inte en ny rad i Markdown. Undvik även att sätta ett omvänt snedstreck allra sist i ett stycke: en hård radbrytning behöver följas av ytterligare en rad med styckeinnehåll.
GitHub-kommentarer och README-filer fungerar olika
GitHubs dokumentation om radbrytningar skiljer mellan .md-filer i kodarkiv och ärenden, pull requests och diskussioner. Vanliga radbyten kan visas som brytningar i dessa samtalsytor, medan en README behöver uttrycklig syntax för hårda radbrytningar.
Det förklarar varför text som kopieras från ett ärende kan se annorlunda ut i en README. Granska målfilen i stället för att förutsätta att alla ytor på samma webbplats använder identiska formateringsregler.
Behåll en fortsättning inom en listpunkt
Gör indraget så att fortsättningen börjar vid listpunktens text:
- Versionsinformation\
Ta med migreringsanvisningarna.
- Installationsguide
Här innehåller den första punkten två visade rader. Den andra punkten förblir separat. För ett separat stycke inom den första punkten använder du en tom rad och behåller indraget i fortsättningen:
- Versionsinformation
Ta med migreringsanvisningarna och kända problem.
- Installationsguide
Guiden till indrag tar upp numrerade listor, nästlade punktlistor och kod inom en punkt.
Lägg till en ny rad i en Markdown-tabellcell
En GFM-tabellrad ska ligga på en enda källtextrad. Om du trycker på Enter inuti innehållet kan tabellraden delas. I renderare som tillåter HTML-radbrytningar använder du det här mönstret:
| Dokument | Ansvariga |
| --- | --- |
| Versionsinformation | Skribent<br>Granskare |
Webbplatsens förhandsvisning stöder exemplet. En målplattform som tar bort HTML kan ta bort brytningen eller visa taggen, så kontrollera plattformen innan du använder mönstret i hela dokumentet. En lista utanför tabellen är ofta lättare att underhålla när en cell behöver flera stycken.
Använd Markdown-tabellgeneratorn för tabelldata och guiden till tabellsyntax för justering och escape-sekvenser för lodräta streck.
Kontrollera det exporterade dokumentet
Innan du använder Markdown-till-Word-konverteraren, testa ett kort exempel med ett vanligt radbyte, en uttrycklig hård radbrytning och en tom rad. Förhandsvisningen ska visa ett sammanhängande stycke, en tvingad radbrytning respektive två separata stycken.
Öppna den nedladdade DOCX-filen och granska adressen, listorna och tabellen. Sidbredden och Words styckeformat kan ändra radbrytningen även när de underliggande brytningarna är korrekta. Rätta Markdown-strukturen först; justera den slutliga typografin i Word när en viss dokumentmall kräver det.