Markdown-syntaksin perusteet ja asiakirjan rakenne
Markdown on kevyt merkintäkieli, jonka avulla tekstiä voidaan muotoilla helposti luettavaan ja kirjoitettavaan muotoon. Sen avulla luodaan rakenteellisia asiakirjoja, jotka kääntyvät vaivattomasti HTML-muotoon ja edelleen painokelpoisiksi tai jaettaviksi PDF-tiedostoiksi. Hyvin muotoillun asiakirjan perusta on selkeä hierarkia, joka alkaa pääotsikosta ja jakautuu tarvittaessa alaotsikoihin.
Työkalu tukee laajasti erilaisia Markdown-syntaksin elementtejä:
- Otsikot: Otsikkotasot määritetään risuaitamerkeillä (
#-# ######). Ensimmäisen tason otsikko toimii usein asiakirjan pääotsikkona. - Luettelot: Järjestämättömät luettelot luodaan viivoilla (
-) tai tähdillä (*), ja järjestetyt luettelot numeroilla. - Taulukot: Sarakkeet erotetaan pystyviivoilla (
|) ja otsikkorivi korostetaan väliviivoilla (-). - Koodilohkot: Koodinpätkät ja laajemmat ohjelmointikoodit suljetaan takatunnusten (```) sisään.
- Lainaukset: Blockquote-lainaukset merkitään suurempi kuin -merkillä (
>). - Linkit ja kuvat: Linkit kirjoitetaan muodossa
[teksti](osoite)ja kuvat muodossa. - Korostukset: Lihavointi tehdään kahdella tähdellä (
**teksti**) ja kursivointi yhdellä tähdellä (*teksti*). - GitHub-tyyliset tehtäväluettelot: Tehtävälistat merkitään hakasulkeilla, joiden sisällä on välilyönti tai x-kirjain (
-tai- [x]).
Reaaliaikainen esikatselu ja käyttöliittymän toiminnot
Kirjoitusprosessin aikana työkalu tarjoaa reaaliaikaisen esikatselun, joka näyttää välittömästi, miltä valmis tyylitelty asiakirja näyttää. Tämä poistaa tarpeen arvailla muotoilujen onnistumista. Käyttöliittymässä on mahdollista vaihtaa erillisen Kirjoita-näkymän ja Esikatselu-näkymän välillä, mikä helpottaa työskentelyä erityisesti pienemmillä näytöillä.
Editorin alareunassa on reaaliaikainen laskuri, joka näyttää tekstin laajuuden:
- Sanaa: Laskee editorissa olevien sanojen kokonaismäärän.
- Merkkiä: Laskee editorissa olevien merkkien kokonaismäärän.
Käyttömukavuutta lisää tumma editori -tila, jonka voi kytkeä päälle tai pois tarpeen mukaan. Kun editori on tyhjä, esikatselualueella näkyy teksti "Muotoiltu esikatselu ilmestyy tähän.". Kun aloitat kirjoittamisen, tilaksi päivittyy "Valmis. Kirjoita tai liitä Markdown-tekstiä nähdäksesi reaaliaikaisen esikatselun.". Jos haluat tyhjentää koko editorin kerralla, voit napsauttaa Tyhjennä-painiketta. Tällöin sana- ja merkkilaskurit nollautuvat, esikatselu tyhjenee ja tilaksi päivittyy "Editori tyhjennetty.".
PDF-tiedostojen luonti selaimessa
Kun asiakirja on valmis ja napsautat Vie PDF-muotoon -painiketta, työkalu hyödyntää selaimesi omaa tulostusmoottoria PDF-tiedoston luomiseen. Tämä tarkoittaa, että erillistä ulkopuolista muunnosohjelmistoa ei tarvita. Painikkeen painaminen avaa selaimesi tulostusikkunan, jossa sinun tulee valita tulostuskohteeksi "Tallenna PDF-muodossa" tai "Tallenna PDF-tiedostona". Samassa ikkunassa voit määrittää sivukoon, sivun suunnan sekä marginaalit.
Jos yrität viedä tyhjää editoria, tulostusikkuna ei avaudu, vaan työkalu näyttää virheilmoituksen "Ei mitään vietävää – kirjoita ensin Markdown-tekstiä.".
Luodun PDF-tiedoston nimeäminen noudattaa automaattista sääntöä:
- PDF käyttää tiedostonimenä Markdown-tekstisi ensimmäistä
#-otsikkoa. - Jos tekstissä ei ole lainkaan päätason
#-otsikkoa, tiedoston nimeksi ehdotetaan "Nimetön asiakirja".
Hakukelpoinen teksti ja toimivat linkit
Tämän työkalun avulla luodut PDF-asiakirjat eivät ole pelkkiä tasaisia kuvatiedostoja. Koska muunnos tapahtuu selaimen tulostusmoottorin kautta, valmiissa PDF-tiedostossa säilyvät seuraavat tärkeät ominaisuudet:
- Aito ja haettavissa oleva teksti: Voit valita tekstiä hiirellä, kopioida sitä leikepöydälle ja hakea asiakirjasta sanoja PDF-lukuohjelmien hakutoiminnoilla.
- Toimivat linkit: Kaikki Markdown-tekstiin lisätyt hyperlinkit säilyvät klikattavina myös valmiissa PDF-tiedostossa, jolloin lukija voi siirtyä suoraan määritettyihin verkko-osoitteisiin.
Tämä tekee asiakirjoista ammattimaisia ja helppokäyttöisiä verrattuna kuvaformaatteihin perustuviin muunnoksiin.
Paikallinen käsittely ja tietosuoja
Tietoturva ja nopeus ovat keskeisiä tekijöitä digitaalisessa dokumentoinnissa. Tämän työkalun kohdalla kaikki Markdown-tekstisi käsitellään selaimessasi. Mitään tietoja tai kirjoittamaasi tekstiä ei ladata BroBroGo-palvelimelle.
Koska tekstin jäsentäminen, esikatselun luominen ja PDF-vienti tapahtuvat täysin paikallisesti omassa laitteessasi, prosessi on välitön eikä vaadi tiedonsiirtoa verkon yli. Tämä varmistaa, että käsittelemäsi teksti pysyy vain omassa hallinnassasi.
Usein kysytyt kysymykset (FAQ)
Ladataanko Markdown-tekstini palvelimelle?
Ei. Jäsentäminen, esikatselu ja PDF-vienti tapahtuvat täysin paikallisesti selaimessasi.
Miten saan PDF-tiedoston?
Napsauta "Vie PDF-muotoon". Selaimen tulostusikkuna avautuu – valitse kohteeksi "Tallenna PDF-muodossa".
Voiko PDF-tiedoston tekstiä valita?
Kyllä. Vienti käyttää selaimen omaa tulostusmoottoria, joten PDF-tiedostossa säilyy aito, haettavissa oleva teksti ja toimivat linkit kuvan sijaan.
Mitä Markdown-ominaisuuksia tuetaan?
Otsikot, luettelot, taulukot, koodilohkot, lainaukset, linkit, kuvat, korostukset ja GitHub-tyyliset tehtäväluettelot.
Mikä on vietävän PDF-tiedostoni nimi?
PDF käyttää Markdown-tiedostosi ensimmäistä #-otsikkoa otsikkonaan ja ehdotettuna tiedostonimenään. Jos Markdown-tiedostossasi ei ole päätason otsikkoa, se viedään nimellä "Nimetön asiakirja".