Vaakaviiva Markdownissa: erottimet, säännöt ja yleiset korjaukset

Lisää vaakaviiva Markdowniin kirjoittamalla kolme yhdysmerkkiä omalle rivilleen ja jättämällä tyhjä rivi niiden ylä- ja alapuolelle:

Ensimmäisen osion loppu.

---

Seuraavan osion alku.

Tuloksena on kahden kappaleen välinen erotin. Markdown kutsuu sitä temaattiseksi katkokseksi; HTML esittää sen elementillä <hr>. Liitä esimerkki Markdown-katselimeen ja tarkista renderöity asiakirja.

Kolme tapaa kirjoittaa erotin

Kaikki nämä muodot luovat temaattisen katkoksen:

Markdown-lähde	Tulos
---	Vaakaviiva
***	Vaakaviiva
___	Vaakaviiva
* * *	Vaakaviiva

Käytä vähintään kolmea samanlaista yhdysmerkkiä, tähteä tai alaviivaa. Välilyönnit merkkien välissä sallitaan. Eri merkkityyppien sekoittaminen, tekstin lisääminen samalle riville tai vain kahden merkin käyttäminen ei luo viivaa. Nämä syntaksisäännöt ovat peräisin CommonMarkin temaattisten katkosten määrittelystä.

Yhdysmerkkien määrä ei säädä viivan näkyvää leveyttä. 20 yhdysmerkkiä ja kolme yhdysmerkkiä tuottavat saman HTML-elementin; kohteen tyylit määräävät sen ulkoasun.

Miksi vaakaviivani muuttui otsikoksi?

Tämä lähde ei sijoita erotinta tekstin ”Julkaisutiedot” alapuolelle:

Julkaisutiedot
---

Se luo toisen tason otsikon. Suoraan kappaletekstin alla olevat yhdysmerkit voivat muodostaa Setext-otsikon, ja tämä tulkinta menee vaakaviivan edelle. Erota ne lisäämällä tyhjä rivi:

Julkaisutiedot

---

Asiakirjan osiossa selvästi merkitty otsikko on usein ymmärrettävämpi:

## Julkaisutiedot

Tuontiprosessi hyväksyy nyt CSV-tiedostot.

Nimeä osiot Markdown-otsikoilla. Käytä vaakaviivaa, kun itse siirtymä on tärkeä, esimerkiksi kirjeen ja liitteen erottamiseen.

Miksi erotin näkyy tavallisena tekstinä?

Tarkista viivaa ympäröivä lähde:

Oire	Todennäköinen syy	Korjaus
Esikatselu näyttää --- koodilohkossa	Neljä välilyöntiä itsenäisen lohkon alussa tai sulkematon rajattu koodilohko	Poista sisennys tai sulje koodilohko
Esikatselu näyttää --	Vain kaksi yhdysmerkkiä	Käytä vähintään kolmea
Merkkien vieressä näkyy tekstiä	Rivillä on muuta tekstiä	Siirrä merkit omalle rivilleen
Viiva näkyy muodossa --- lauseen sisällä	Merkit ovat gravismerkkien välissä	Poista gravismerkit, jos tarkoitus on luoda erotin
Edellinen kappale muuttuu otsikoksi	----rivin yläpuolelta puuttuu tyhjä rivi	Lisää tyhjä rivi

Asiakirjan ylimmällä tasolla temaattisen katkoksen edessä sallitaan enintään kolme välilyöntiä. Luetteloissa sisennys määrittää myös, mihin kohtaan sisältö kuuluu, joten tarkista ympäröivä luettelo sen sijaan, että poistaisit kaikki välilyönnit.

Vaakaviiva ei ole sama asia kuin rivinvaihto

Erotin erottaa osiot toisistaan. Se ei pelkästään siirrä seuraavia sanoja uudelle riville.

Käytä osoitteessa pakotettua rivinvaihtoa:

120 Market Street\
San Francisco, CA

Jätä tyhjä rivi uuden kappaleen aloittamiseksi. Käytä osioiden erottamiseen ----merkintää omalla rivillään. Markdown-rivinvaihtojen opas selittää loppuvälilyönnit, kenoviivat sekä GitHubin erilaisen rivinvaihtokäyttäytymisen tiedostoissa ja kommenteissa.

Erottimen sijoittaminen lohkolainaukseen

Säilytä >-etuliite jokaisella rivillä, myös erottimen rivillä ja tyhjillä riveillä:

> Alkuperäinen ehdotus.
>
> ---
>
> Tarkistajan antama lisätausta.

Erotin pysyy lainauksen sisällä. Jos poistat >-merkin viivan edestä, lainaus voi päättyä ja erotin siirtyä ympäröivään asiakirjaan. Katso useita kappaleita ja sisäkkäisiä lainauksia koskevat lohkolainausesimerkit.

Taulukon erotin ei ole vaakaviiva

Tämä rivi kuuluu taulukkoon:

| Muoto | Muokattava |
| --- | :---: |
| Markdown | Kyllä |

Pystyviivat ja valinnaiset kaksoispisteet kuvaavat sarakkeita. Ne eivät lisää koko sivun levyistä erotinta. Luo taulukko Markdown-taulukkogeneraattorilla tai käytä CSV Markdowniksi -muunninta, jos tiedot ovat jo laskentataulukossa.

Vaakaviivat ja viedyt asiakirjat

Temaattinen katkos ei ole sivunvaihtokomento. PDF- tai Word-viejä päättää sivujen päättymiskohdat asettelu- ja sivutussääntöjensä perusteella. Älä lisää yhdysmerkkejä odottaen seuraavan osion alkavan uudelta sivulta.

Jos hallitset verkkosivun CSS:ää, voit muotoilla luodun <hr>-elementin sivuston tyylitiedostossa. Ylläpidetty Markdown-palvelu ei välttämättä salli mukautettua CSS:ää. Tarkista lopullinen kohde tai viety asiakirja etenkin silloin, kun erotin välittää merkityksen, jonka on säilyttävä tulostettaessa.

Usein kysytyt kysymykset

Tarvitsenko tyhjiä rivejä vaakaviivan ympärille?

CommonMark ei vaadi niitä kaikissa tilanteissa, mutta niiden käyttö välttää yleisen ----merkinnän otsikkotulkinnan ja tekee lähdetiedostoista helpommin luettavia.

Voinko käyttää HTML:n hr-tagia?

<hr> toimii renderöijissä, jotka sallivat raaka-HTML:n. Markdownin --- sopii paremmin Markdown-asiakirjaan. MD File Viewer -editori poistaa käyttäjän syöttämät HTML-tagit, mutta Markdown-erottimen syntaksi renderöityy normaalisti.

Miten näytän kolme yhdysmerkkiä luomatta erotinta?

Kirjoita syntaksiesimerkki tekstinsisäisenä koodina: `---`. Jos haluat tavallista tekstiä omalle rivilleen, suojaa ensimmäinen yhdysmerkki kenoviivalla: \---.

Pidä Markdown-muistilista käsillä muita yleisiä muotoiluja varten.