Regeleinden in Markdown: nieuwe regels, alinea's en tabelcellen
Voeg een nieuwe regel toe in Markdown met een backslash, twee spaties of een lege regel. Herstel regeleinden in README, lijsten en tabellen vóór export naar Word.
Om binnen een Markdown-alinea een nieuwe regel te beginnen, zet je een backslash aan het einde van de eerste regel en druk je op Enter. Om een afzonderlijke alinea te beginnen, laat je een lege regel vrij. Deze methoden leveren verschillende documentstructuren op, wat belangrijk is als je later een README, adres of rapport naar Word exporteert.
Documentatieteam\
Voorbeeldstraat 42\
Portland, Oregon
Het adres blijft één alinea die op drie regels wordt weergegeven. Plak het in het Markdown-voorbeeld om het met de onderstaande voorbeelden te vergelijken.
Kies het soort regeleinde dat je nodig hebt
| Gewenst resultaat | Markdown-bron | Typisch gebruik |
|---|---|---|
| Doorgaan met dezelfde alinea | Eén gewoon regeleinde | Lange regels in het bronbestand verdelen |
| Een andere regel in dezelfde alinea beginnen | Backslash gevolgd door Enter | Adressen en korte verzen |
| Een nieuwe alinea beginnen | Een lege regel | Ideeën in een artikel scheiden |
| Een regel in een tabelcel afbreken | <br> waar HTML wordt ondersteund | Twee korte labels in één cel |
Een regeleinde maakt geen pagina-einde. Als de volgende sectie in een geëxporteerd document op een nieuw blad moet beginnen, lees dan de afzonderlijke handleiding voor pagina-einden in Markdown.
Waarom Enter op een spatie kan lijken
Probeer deze bron:
Het concept is klaar.
De beoordelaar kan het vandaag openen.
In het voorbeeld op deze site behoren beide zinnen tot één alinea en lopen ze door. Het regeleinde blijft nuttig in het bronbestand, maar dwingt de browser niet om een nieuwe zichtbare regel te beginnen. De browser kan de tekst nog steeds afbreken op basis van de beschikbare breedte.
Voeg nu een lege regel in:
Het concept is klaar.
De beoordelaar kan het vandaag openen.
Het voorbeeld geeft twee alinea's weer. Gebruik deze versie wanneer de tweede zin een nieuwe gedachte begint. Meerdere lege regels toevoegen is geen betrouwbare manier om meer verticale ruimte te vragen; de alineaopmaak wordt bepaald door de renderer of het documentsjabloon.
Een backslash of twee spaties aan het einde
CommonMark definieert zowel twee spaties vóór een regeleinde als een backslash vóór een regeleinde als syntaxis voor een harde regelafbreking binnen een alinea. De CommonMark-voorbeelden van harde regelafbrekingen beschrijven beide vormen.
De versie met een backslash is zichtbaar wanneer je een bestand beoordeelt:
Opgesteld door het documentatieteam\
Beoordeeld door de releaseverantwoordelijke
Het alternatief is precies twee spaties na documentatieteam typen en vervolgens op Enter drukken. Deze spaties zijn in veel editors onzichtbaar en kunnen worden verwijderd door automatisch opschonen van spaties aan het einde van regels. Verdwijnt een afbreking na het opslaan, controleer dan de witruimte-instellingen of gebruik de backslash.
Typ niet de twee tekens \n in gewone tekst in de verwachting dat er een regel wordt afgebroken. Dat is een conventie voor tekenreeksen in programmeertalen, geen Markdown-regeleinde. Zet ook geen backslash helemaal aan het einde van een alinea: na een harde regelafbreking moet nog een regel met inhoud van dezelfde alinea volgen.
GitHub-opmerkingen en README-bestanden gedragen zich anders
De GitHub-documentatie over regeleinden maakt onderscheid tussen .md-bestanden in een repository en issues, pull requests en discussies. Gewone regeleinden kunnen in die gespreksomgevingen als afbrekingen worden weergegeven, terwijl een README expliciete syntaxis voor harde regelafbrekingen nodig heeft.
Dat verschil verklaart waarom tekst die uit een issue is gekopieerd er in een README anders uit kan zien. Controleer het doelbestand in plaats van aan te nemen dat elk onderdeel van dezelfde website identieke opmaakregels gebruikt.
Houd een vervolg binnen een lijstitem
Laat het vervolg inspringen zodat het is uitgelijnd met het begin van de tekst van het item:
- Releaseopmerkingen\
Neem de migratie-instructies op.
- Installatiehandleiding
Hier bevat het eerste item twee zichtbare regels. Het tweede item blijft afzonderlijk. Gebruik voor een afzonderlijke alinea binnen het eerste item een lege regel en houd het vervolg ingesprongen:
- Releaseopmerkingen
Neem de migratie-instructies en bekende problemen op.
- Installatiehandleiding
De handleiding voor inspringen behandelt genummerde lijsten, geneste opsommingstekens en code binnen een item.
Voeg een nieuwe regel toe in een Markdown-tabelcel
Een GFM-tabelrij hoort op één regel van het bronbestand te staan. Op Enter drukken binnen de inhoud kan de rij splitsen. Gebruik in renderers die HTML-regelafbrekingen toestaan dit patroon:
| Document | Verantwoordelijken |
| --- | --- |
| Releaseopmerkingen | Schrijver<br>Beoordelaar |
Het voorbeeld op deze site ondersteunt dit. Een bestemming die HTML verwijdert, kan de afbreking weghalen of de tag tonen. Controleer die omgeving dus voordat je deze aanpak in het hele document gebruikt. Een lijst buiten de tabel is vaak makkelijker te onderhouden wanneer een cel meerdere alinea's nodig heeft.
Gebruik de Markdown-tabelgenerator voor tabelgegevens en de handleiding voor tabelsyntaxis voor uitlijning en verticale strepen met escapetekens.
Controleer het geëxporteerde document
Test voordat je de Markdown-naar-Word-converter gebruikt een kort fragment met één gewoon regeleinde, één expliciete harde regelafbreking en één lege regel. Het voorbeeld moet respectievelijk één doorlopende alinea, een geforceerde regelafbreking en twee afzonderlijke alinea's tonen.
Open het gedownloade DOCX-bestand en controleer het adres, de lijsten en de tabel. De paginabreedte en alineastijlen van Word kunnen de automatische regelverdeling veranderen, ook wanneer de onderliggende afbrekingen correct zijn. Herstel eerst de Markdown-structuur; pas de uiteindelijke typografie in Word aan wanneer een bepaald documentsjabloon dat vereist.