Syöte-Markdown

Käsitelty tulos

Markdown-rivinvaihdon esimerkkejä

Normalisointitila yhdistää rivitetyt rivit yksittäisiksi kappaleiksi. Esimerkki:

Rivitetyt rivit kappaleiksi

Syöte (rivitetyt rivit):

Syöte

Normalisoitu tulos:

Tulos

Käytä Normalisoi kappaleet -tilaa ja Esimerkki-painiketta.

Mikä on Markdown-rivinvaihtotyökalu?

Markdown käsittelee rivinvaihtoja eri tavalla kuin HTML. Yksittäinen rivinvaihto ei usein luo katkosta HTML:ssä; tarvitset kaksi välilyöntiä rivin lopussa tai tyhjän rivin. Tämä työkalu lisää kovat rivinvaihdot (kaksi välilyöntiä + rivinvaihto) tai normalisoi kappaleet. CommonMark-spesifikaatio määrittelee säännöt.

Käsittely tapahtuu kokonaan selaimessasi. Mitään ei lähetetä palvelimelle. Kaksi tilaa: Lisää kovat rivinvaihdot (lisää rivinvaihdot jokaisen rivin jälkeen) tai Normalisoi kappaleet (yhdistää rivitetyt rivit yksittäisiksi kappaleiksi). Muotoiluun käytä Markdown-muotoilutyökalua.

Kuinka käyttää tätä työkalua

1

Liitä tai lataa Markdown

Kopioi Markdownisi ja liitä se vasempaan editoriin. Voit myös napsauttaa Lataa ladataksesi .md- tai .markdown-tiedoston. Esimerkki-painike lataa esimerkkidataa.

2

Valitse tila

Valitse Lisää kovat rivinvaihdot lisätäksesi rivinvaihdot jokaisen rivin jälkeen, tai Normalisoi kappaleet yhdistääksesi rivitetyt rivit. Oikea paneeli päivittyy automaattisesti.

3

Kopioi tai lataa

Käytä Kopioi tai Lataa. Muotoiluun tai validointiin käytä Markdown-muotoilutyökalua tai Markdown-validaattoria.

Milloin rivinvaihtokäsittely auttaa

Kun CMS:stä tai viennistä saatu Markdown sisältää yksittäisiä rivinvaihtoja, jotka eivät renderöidy katkoksina, kovien rivinvaihtojen lisääminen korjaa sen. GitHub Flavored Markdown -spesifikaatio ja Markdown Guide käsittelevät rivinvaihtosäännöt. Kun tekstissä on epäjohdonmukainen rivitys (esim. sähköpostista tai kopioinnista), kappaleiden normalisointi luo siistin kappaleet. Runous tai osoitteet tarvitsevat usein kovat rivinvaihdot.

Usein kysyttyä

Miksi Enterin painaminen ei luo uutta riviä Markdownissa?

Markdownissa yksittäinen rivinvaihto käsitellään välilyöntinä — ei rivinvaihtona. Useimmat renderöijät noudattavat CommonMark-spesifikaatiota, joka vaatii kaksi välilyöntiä rivin lopussa (kova rivinvaihto) tai tyhjän rivin (kappalevaihto) näkyvän erottelun luomiseksi renderöidyssä tuloksessa.

Mitä eroa on pehmeällä ja kovalla rivinvaihdolla?

Pehmeä rivinvaihto on yksittäinen rivinvaihto Markdown-lähdekoodissa — renderöityy välilyönniksi HTML:ssä. Kova rivinvaihto on kaksi peräkkäistä välilyöntiä + rivinvaihto — renderöityy <br>-tagiksi. Tämän työkalun "Lisää kovat rivinvaihdot" -tila muuntaa jokaisen yksittäisen rivinvaihdon kovaksi rivinvaihdoksi.

Voinko käyttää tätä Wordista tai Google Docsista kopioidun Markdownin korjaamiseen?

Kyllä — se on yksi yleisimmistä käyttötapauksista. Kun kopioit tekstiä Wordista tai Google Docsista, rivit katkeavat usein sarakkeen leveydellä luoden kymmeniä lyhyitä rivejä, jotka sulautuvat yhdeksi tekstiseinäksi renderöinnin yhteydessä. Käytä Normalisoi kappaleet -tilaa yhdistääksesi nämä katkaistut rivit takaisin oikeiksi kappaleiksi.

Onko se yhteensopiva GitHub Flavored Markdownin kanssa?

Kyllä. Kovien rivinvaihtojen muoto (kaksi peräkkäistä välilyöntiä) on tuettu GitHub Flavored Markdownissa ja kaikissa CommonMark-yhteensopivissa renderöijissä. Normalisointitila tuottaa standardeja kappaleenvaihtorivejä, jotka toimivat kaikkialla.

Milloin käyttää kovia rivinvaihtoja?

Kun jokaisen rivin tulisi renderöityä erillisenä rivinä (esim. osoitteet, runous tai sisältö, joka on tarkoitettu yksittäisille rivinvaihdoille). Lisää kaksi välilyöntiä + rivinvaihdon.

Liittyvät työkalut

CommonMark. CommonMark-rivinvaihdot. Markdown Guide. GFM. GitHub. W3C HTML.