Markdown-muunnin

Acrafto Team Teksti
Päivitetty

Alussa olevaa front matter -osaa ei tulosteta. Sen otsikkoa ”Kvartaaliraportti” käytetään asiakirjan otsikkona.

Tulos
Kvartaaliraportti

Tämä asiakirja näyttää, mitä muunnin säilyttää: otsikot, luettelot, taulukot, koodin, lainaukset, linkit ja alaviitteet.1

Kohokohdat
  • Liikevaihto kasvoi 12 % edelliseen kvartaaliin verrattuna
  • Tiimiin liittyi syyskuussa kaksi uutta jäsentä
  • Kaikki luvut ovat projektin sivulla
Luvut
Kuukausi Tilaukset Muutos
Heinäkuu 1 240 +4 %
Elokuu 1 310 +6 %
Syyskuu 1 395 +6 %
Seuraavat vaiheet
  1. Viimeistele perehdytysopas
  2. Käy hinnoittelusivu läpi
    • Vertaa vanhaan versioon
    • Pyydä asiakastuelta palautetta
  3. Suunnittele seuraava julkaisu
  • Kerää tiedot
  • Lähetä raportti

Luvut on pyöristetty lähimpään kokonaiseen tilaukseen.

npm run build && npm run deploy

  1. Otsikko tulee alussa olevasta YAML front matter -osasta, jota ei tulosteta. ↩︎

Asetukset

Muunna Markdown PDF:ksi, Wordiksi, HTML:ksi tai pelkäksi tekstiksi tällä Markdown-muuntimella, joka toimii suoraan selaimessasi: liitä teksti tai avaa .md-tiedosto, valitse muoto ja lataa tulos. Se muuntaa myös Markdown-taulukot Excel- tai CSV-tiedostoiksi, tekee e-kirjoja EPUB-muodossa ja LaTeX-asiakirjoja sekä kirjoittaa Markdownin uudelleen Jiraa, Confluencea, Slackia ja foorumien BBCodea varten. Tekstin vieressä oleva esikatselu näyttää tuloksen sitä mukaa kuin säädät asetuksia. Tiedostojasi ei lähetetä minnekään, rekisteröitymistä ei tarvita, eikä vesileimaa tai sivurajoitusta ole.

Näin muunnat Markdown-tiedoston

  1. Liitä Markdown vasempaan kenttään tai napsauta Avaa tiedostoja ja valitse yksi tai useampi .md-tiedosto. Myös tiedostojen pudottaminen muuntimeen toimii.
  2. Valitse muoto kohdasta Muunna muotoon. Ryhmässä Asiakirjat ovat PDF, Word (DOCX), EPUB, LaTeX, HTML ja Teksti (TXT), ryhmässä Taulukot ovat Excel (XLSX) ja CSV, ja ryhmässä Sovelluksille ovat Jira / Confluence, Slack ja BBCode.
  3. Tarkista esikatselu kohdassa Tulos ja muuta halutessasi sivukokoa, reunuksia, fonttia tai muita asetuksia kohdassa Asetukset.
  4. Muokkaa tarvittaessa kenttää Tiedostonimi ja napsauta latauspainiketta. Tekstimuodot voi myös kopioida suoraan leikepöydälle, ja Jiran, Slackin ja BBCoden kohdalla pääpainike kopioi tuloksen.

Muuntimessa on aluksi esimerkkinä kvartaaliraportti, jonka front matterissa on otsikko ja jossa on luetteloita, taulukko oikealle tasatuilla luvuilla, tarkistuslista, lainaus, koodilohko ja alaviite. Muunna se kuhunkin muotoon, niin näet, miltä elementit näyttävät.

Markdown to PDF -muunnin

PDF rakennetaan selaimessasi oikeasta, valittavasta tekstistä eikä kuvakaappauksesta. Otsikot näkyvät kirjanmerkkeinä PDF-lukijan sivupaneelissa, linkit pysyvät napsautettavina, ja otsikoihin tai alaviitteisiin vievät linkit hyppäävät asiakirjan sisällä. Taulukot säilyttävät sarakkeiden tasauksen ja toistavat otsikkorivin jokaisella sivulla, jolle ne jatkuvat, sisäkkäiset luettelot numeroidaan 1., a., i. kuten Wordissa, ja tarkistuslistoihin piirretään valintaruudut. Koodilohkoissa käytetään tasalevyistä fonttia vaaleanharmaalla taustalla, joten sisennykset pysyvät täsmälleen sellaisina kuin ne on kirjoitettu.

Kohdasta Asetukset löytyvät Sivukoko (A4 tai Letter, esivalittu selaimesi kielen mukaan), Reunukset (kapeat 1,27 cm, normaalit 2,54 cm tai leveät 3,81 cm eli 0,5, 1 tai 1,5 tuumaa), Fontti (päätteellinen tai päätteetön), Fonttikoko sekä valinta Sivunumerot. Sisällysluettelo lisää otsikon jälkeen luettelon otsikoista sivunumeroineen.

Fontit kulkevat PDF:n mukana, joten tiedosto näyttää samalta jokaisella tietokoneella ja tulostimella. Ne kattavat latinalaiset, kyrilliset ja kreikkalaiset kirjaimet sekä vietnamin, ja lisäksi nuolet, matemaattiset merkit ja symbolit kuten → ≤ ✓ ★. Kiinan, japanin, korean, arabian, heprean ja thain kirjoitusjärjestelmät, intialaiset kirjaimistot ja emojit eivät ole mukana. Kun asiakirjassa on niitä, muunnin kertoo, mistä merkeistä on kyse, ja latauspainike vaihtuu painikkeeksi Tallenna PDF-muodossa: se avaa selaimesi tulostusikkunan, joka käyttää järjestelmäsi fontteja ja kirjoittaa arabian ja heprean oikealta vasemmalle. Valitse tulostimeksi Tallenna PDF-muodossa, niin kohdassa Asetukset valitut sivukoko, reunukset ja fontti säilyvät.

Muunna Markdown Wordiksi (DOCX)

Word-tiedostossa on aito asiakirjarakenne eikä vain tekstiä, joka näyttää siltä. Otsikot käyttävät Wordin valmiita tyylejä Otsikko 1:stä Otsikko 6:een, joten Wordin siirtymisruutu luettelee ne ja Viittaukset-välilehden Sisällysluettelo tekee sisällyssivun yhdellä napsautuksella. Luettelot ovat oikeita Word-luetteloita, jotka säilyttävät numeroinnin, kun lisäät kohtia, jokainen numeroitu luettelo alkaa alusta numerosta 1 (tai kirjoittamastasi numerosta), ja tehtäväkohdat saavat merkit ☐ ja ☒. Taulukot toistavat otsikkorivinsä jokaisella sivulla, alaviitteistä tulee oikeita Wordin alaviitteitä sivun alareunaan, ja otsikoihin vievät linkit hyppäävät niihin.

Valitse sivukoko, reunukset, fonttikoko ja jokin vakiofonteista Calibri, Cambria, Arial tai Times New Roman. Word näyttää tiedoston sillä fontilla, joka on asennettu sen avaavaan tietokoneeseen, joten tämä esikatselu on hyvä suuntaa antava kuva eikä pikselintarkka kopio. DOCX-tiedosto avautuu Microsoft Wordissa, LibreOfficessa ja muissa ohjelmissa, jotka lukevat Office Open XML -muotoa. Jos haluat Markdownin Google Docsiin, lataa .docx-tiedosto Google Driveen ja avaa se Google Docsilla tai kopioi teksti Markdown-editorin toiminnolla Kopioi muotoiltuna tekstinä ja liitä se asiakirjaan.

Markdown HTML:ksi

Kokonainen sivu tyyleineen antaa itsenäisen .html-tiedoston, jossa on oma siisti tyylitiedosto. Se toimii ilman verkkoyhteyttä, seuraa lukijan järjestelmän vaaleaa tai tummaa tilaa ja tulostuu hyvin. Vain sisältö, CMS:ää varten antaa pelkät HTML-elementit (<h2>, <p>, <ul>, <table> ja niin edelleen) ilman tyylejä, valmiina liitettäväksi WordPressiin, Ghostiin, uutiskirjetyökaluun tai omaan sivupohjaasi. Vaihda esikatselu näkymien Renderöity ja Koodi välillä, niin näet molemmat puolet.

HTML noudattaa CommonMark- ja GitHub Flavored Markdown -määrityksiä (molemmat englanniksi). Otsikot saavat id-attribuutit kuten GitHubissa, joten #julkaisusuunnitelma-linkit toimivat edelleen, ja alaviitteissä on linkit takaisin kohtiin, joissa niihin viitattiin. Lähdetekstissä olevasta raa’asta HTML:stä poistetaan skriptit, tapahtumankäsittelijät ja javascript:-linkit, joten jonkun toisen Markdown-tiedosto ei voi salakuljettaa koodia sivullesi.

Markdown pelkäksi tekstiksi

Teksti (TXT) poistaa Markdown-syntaksin ja pitää rakenteen luettavana: luettelomerkeistä tulee ”- ”, numeroidut kohdat säilyttävät numeronsa, tehtävät näkyvät muodossa [ ] ja [x], lainaukset alkavat merkeillä ”> ”, taulukot tasataan sarakkeisiin ja alaviitteet luetellaan lopussa muodossa [1], [2]. Säilytä linkkien osoitteet kirjoittaa URL-osoitteen sulkeisiin jokaisen linkin perään, joten mitään ei katoa, kun teksti päätyy sähköpostiin, lomakkeen kenttään tai järjestelmään, joka ei ymmärrä Markdownia. Rivin pituus voi rivittää pitkät rivit 72 tai 80 merkin kohdalta pelkkää tekstiä käyttävää sähköpostia varten.

Tästä on hyötyä myös tekoälychattien vastauksille, jotka tulevat Markdown-muodossa: tekstiksi muuntaminen poistaa tähdet ja risuaidat ennen kuin liität vastauksen muualle.

Markdown-taulukko Exceliin ja CSV:ksi

Excel (XLSX) ja CSV poimivat asiakirjasta vain taulukot, mikä on kätevää README-tiedostojen, dokumentaation tai tekoälychattien vastausten taulukoille. Excelissä jokaisesta taulukosta tulee oma välilehti, joka nimetään sen yläpuolella olevan otsikon mukaan. Luvut tallennetaan oikeina lukuina, myös tuhaterottimella kirjoitetut kuten 1 240 ja prosentit kuten 12 %, joten voit laskea niitä yhteen ja lajitella niitä heti, kun taas arvot kuten 007 tai postinumero säilyttävät etunollansa tekstinä. Otsikkorivi on lihavoitu ja lukittu, ja jokainen välilehti saa suodattimen.

CSV kirjoittaa yhden tiedoston taulukkoa kohden, ja jos taulukoita on useampi, ne pakataan ZIP-tiedostoon. Kohdassa Asetukset valitset Erotin-merkin: Excel, jonka kieli käyttää desimaalipilkkua, kuten suomi, saksa tai ranska, odottaa puolipistettä, muuten koko rivi päätyy yhteen sarakkeeseen. Excel-yhteensopiva (UTF-8 ja BOM) saa Excelin lukemaan ääkköset ja muut erikoismerkit oikein. Kopioi taulukot vie taulukot leikepöydälle, joten voit liittää ne Exceliin tai Google Sheetsiin tallentamatta tiedostoa.

Markdown Jira-, Confluence-, Slack- ja BBCode-muotoon

Nämä kolme muotoa ovat tekstiä sovelluksille, jotka eivät lue tavallista Markdownia, joten pääpainike kopioi tuloksen:

  • Jira / Confluence kirjoittaa wikimerkintää: h2.-otsikot, *bold*, _italic_, {code}-lohkot, ||header||-taulukot, [text|url]-linkit sekä #- tai *-luettelot. Se on tarkoitettu Jiran ja Confluencen Data Center- ja Server-versioille sekä vanhemmille kentille, joissa käytetään yhä wikimerkintää. Jira Cloudin nykyinen editori lukee Markdownia itse, joten sinne voit liittää alkuperäisen tekstin.
  • Slack kirjoittaa Slackin omaa merkintää: *bold*, _italic_, ~strikethrough~, koodi, lainaukset ja [text](url)-linkit, luettelot luettelomerkkeinä ja taulukot tasattuina koodilohkoina, koska Slackissa ei ole taulukoita. Ota Slackissa käyttöön Format messages with markup kohdassa Preferences, Advanced, niin näet muotoilun lähettämisen jälkeen. Boteille ja webhookeille (API-muoto) kirjoittaa linkit muodossa <url|text> ja suojaa merkit &, < ja >, kuten Slackin API edellyttää.
  • BBCode käyttää tageja, jotka phpBB, vBulletin, XenForo, SMF ja MyBB kaikki ymmärtävät: [b], [i], [u], [s], [url], [img], [quote], [list] ja [code]. Otsikoista tulee lihavoituja rivejä, koska otsikkojen koot vaihtelevat foorumeittain, ja taulukoista tulee tasattuja [code]-lohkoja.

Markdown EPUB-muotoon lukulaitteille ja Kindlelle

EPUB tekee e-kirjan, jossa on nimiösivu, sisällysluettelo ja yksi luku kutakin ylimmän tason otsikkoa kohden. Kun asiakirjassa on vain yksi tason 1 otsikko, jota käytetään kirjan nimenä, luvut alkavat sen sijaan tason 2 otsikoista; voit valita tämän itse kohdan Asetukset valinnalla Lukujako. Alaviitteet kootaan loppuviitteiksi, joista on linkit takaisin tekstiin, verkko-osoitteelliset kuvat upotetaan, ja front matterin otsikko ja tekijä näkyvät kirjan tiedoissa.

Tiedostot läpäisevät virallisen EPUB-validaattorin, EPUBCheckin (englanniksi), joten ne avautuvat Apple Booksissa, Kobossa, Google Play Booksissa ja Calibressa. Amazonin Send to Kindle hyväksyy myös EPUB-tiedostot ja muuntaa ne Kindlellesi, ja Kindle Direct Publishing ottaa vastaan EPUB-käsikirjoituksia, kun kansikuva ladataan erikseen.

Markdown LaTeX-muotoon

LaTeX tuottaa kokonaisen article-asiakirjan, joka lataa vain tarvitsemansa paketit, tai valinnalla Vain sisältö, liitettäväksi asiakirjaan pelkän sisällön jo olemassa olevaan artikkeliisi, esimerkiksi Overleafissa. Otsikoista tulee \section ja \subsection, luetteloista itemize ja enumerate, taulukoista tabular sarakkeiden tasaus säilyttäen, koodi menee verbatim-ympäristöön, alaviitteistä tulee oikeita \footnote-komentoja ja linkeissä käytetään komentoa \href. Merkit, joita LaTeX käsittelee komentoina, kuten %, $, &, # ja _, suojataan. LaTeX ei voi ladata kuvia verkosta, joten jokaisesta kuvasta tulee \includegraphics-rivi, jossa on kuvan tiedostonimi ja alkuperäinen osoite kommenttina; lataa kuva .tex-tiedoston viereen. Käännä pdfLaTeXilla tai, jos tekstissä on muita kuin latinalaisia kirjaimia, XeLaTeXilla tai LuaLaTeXilla.

Muunna useita .md-tiedostoja kerralla

Avaa tai pudota useita tiedostoja, niin tekstikentän alle ilmestyy luettelo. Muokkaa lataa tiedoston kenttään, jotta voit tarkistaa tai korjata sen, Poista ottaa sen pois erästä ja Lataa kaikki ZIP-tiedostona muuntaa jokaisen tiedoston valittuun muotoon samoilla asetuksilla. Jokainen tiedosto säilyttää nimensä, joten tiedostosta notes.md tulee notes.pdf. Tiedostot, jotka eivät ole tekstiä, kuten kuvat, ohitetaan, ja siitä näytetään ilmoitus.

Front matter, kuvat ja tiedostonimet

Monet Markdown-tiedostot alkavat kahden ----rivin välissä olevalla YAML front matter -lohkolla (englanniksi), jota käyttävät Jekyll, Hugo, Obsidian ja muut työkalut. Muunnin ei tulosta sitä. Sen title-kentästä tulee asiakirjan otsikko PDF- ja Word-tiedoston ominaisuuksissa ja HTML:n <title>-elementissä sekä ehdotettu tiedostonimi; author-kentästä tulee tekijä. Ilman front matteria tiedosto nimetään ensimmäisen ylimmän tason otsikon mukaan.

Selaimesi lataa kuvat, joilla on täydellinen verkko-osoite, ja upottaa ne PDF- ja Word-tiedostoon, kunhan kuvia isännöivä palvelin sallii sen (CORS, englanniksi). GIF-, WebP- ja SVG-kuvat muunnetaan samalla PNG-muotoon.

Usein kysytyt kysymykset

Lähetetäänkö Markdown-tiedostoni palvelimelle?

Ei. Tiedostojen lukeminen, PDF- ja Word-asiakirjojen rakentaminen ja ZIP-tiedoston pakkaaminen tapahtuvat kaikki selaimessasi, joten yksityiset muistiinpanot ja sisäinen dokumentaatio eivät koskaan poistu tietokoneeltasi. Muunnin muistaa vain asetuksesi, kuten muodon ja sivukoon, ei tekstiä.

Miksi kuvat puuttuvat PDF-tiedostostani?

Kuvia, jotka on kirjoitettu tietokoneesi polkuna, kuten images/chart.png, verkkosivu ei voi lukea, joten ne korvataan kuvauksellaan. Käytä täydellistä https-osoitetta tai vie kuva ensin verkkoon. Jotkin verkkosivustot myös estävät muita sivustoja lataamasta kuviaan, jolloin käytetään niin ikään kuvausta, ja muunnin kertoo, montako kuvaa se ei pystynyt lataamaan.

Voinko muuntaa kiinan-, japanin- tai arabiankielistä tekstiä sisältävän Markdownin PDF:ksi?

Kyllä, selaimesi avulla. PDF:ään upotetut fontit eivät sisällä näitä kirjoitusjärjestelmiä, joten tällaisessa asiakirjassa latauspainike vaihtuu painikkeeksi Tallenna PDF-muodossa ja avaa tulostusikkunan, jossa valitset tulostimeksi Tallenna PDF-muodossa. Selain käyttää järjestelmäsi fontteja, teksti pysyy valittavana, ja arabia tai heprea kulkee oikealta vasemmalle. Myös Word (DOCX) ja HTML säilyttävät jokaisen merkin.

Tukeeko muunnin LaTeX-matematiikkaa tai Mermaid-kaavioita?

Ei. Dollarimerkkien väliin kirjoitetut kaavat jäävät pelkäksi tekstiksi, ja Mermaid-lohko muunnetaan kuten mikä tahansa muu koodilohko. Taulukot, tarkistuslistat, alaviitteet, koodi ja kaikki muu GitHub Flavored Markdownista on tuettu jokaisessa muodossa.

Voinko muuntaa Wordin tai Google Docsin Markdowniksi?

Kyllä, Markdown-editorilla: liitä Wordista, Google Docsista tai verkkosivulta kopioitu teksti, niin sen muotoilu muuttuu Markdowniksi otsikot, luettelot, linkit ja taulukot mukaan lukien. PDF:n muuntamista takaisin Markdowniksi ei tueta, koska PDF tallentaa sivulle sijoiteltua tekstiä eikä otsikoita, luetteloita ja taulukoita.

Miten muunnan Markdown-taulukon Exceliin?

Liitä Markdown, jossa taulukko on, valitse Excel (XLSX) ja lataa tiedosto. Jokaisesta taulukosta tulee välilehti, jolla luvut on tallennettu lukuina. Jos tarvitset vain arvot jo avoinna olevaan laskentataulukkoon, napsauta Kopioi taulukot ja liitä Exceliin tai Google Sheetsiin.

Miksi Excel laittaa koko CSV-rivin yhteen sarakkeeseen?

Excel jakaa CSV-tiedoston järjestelmäsi luetteloerottimen mukaan. Kielissä, joissa desimaalit kirjoitetaan pilkulla, kuten suomessa, saksassa, ranskassa tai tšekissä, tämä erotin on puolipiste. Valitse Puolipiste kohdassa Erotin ja lataa uudelleen. Jos ääkköset näkyvät väärin, pidä Excel-yhteensopiva (UTF-8 ja BOM) päällä.

Voinko lähettää EPUB-tiedoston Kindleeni?

Kyllä. Amazonin Send to Kindle hyväksyy EPUB-tiedostot sähköpostitse, Kindle-sovelluksessa tai Send to Kindle -verkkosivustolla ja muuntaa ne Kindle-kirjastoa varten. Myös Kindle Direct Publishing hyväksyy EPUB-tiedostot, jos haluat julkaista kirjan.

Käyttääkö Jira Cloud yhä wikimerkintää?

Ei nykyisessä editorissaan, joka lukee Markdownia ja muuttaa sen muotoiluksi, kun liität tai kirjoitat. Jira / Confluence -muoto on tarkoitettu Jiran ja Confluencen Data Center- ja Server-versioille sekä vanhemmille kentille, joissa näkyy yhä wikimerkintä. Jira Cloudiin voit liittää sen sijaan alkuperäisen Markdownin.

Voinko avata LaTeX-tiedoston Overleafissa?

Kyllä. Luo uusi tyhjä projekti, lähetä .tex-tiedosto palveluun tai liitä sen sisältö ja lähetä myös kuvat, joihin tiedosto viittaa. Valinnalla Vain sisältö, liitettäväksi asiakirjaan saat pelkän sisällön projektiin, jolla on jo oma johdanto-osa (preamble).

Miten muunnan Markdownin PDF:ksi tai Wordiksi komentorivillä?

Tavallinen työkalu on Pandoc (englanniksi): pandoc notes.md -o notes.docx luo Word-tiedoston saman tien, kun taas PDF-tuloste vaatii lisäksi asennetun LaTeX-moottorin. Tämä sivu ei vaadi asennusta ja näyttää ensin esikatselun, mikä on helpompaa yksittäiselle asiakirjalle tai pienelle tiedostoerälle.

Onko tiedostokoolla tai sivumäärällä rajoitusta?

Kussakin tiedostossa voi olla enintään 20 MB tekstiä, mikä on paljon enemmän kuin missään tavallisessa asiakirjassa, eikä sivurajoitusta tai vesileimaa ole. Hyvin pitkien, paljon kuvia sisältävien asiakirjojen rakentaminen kestää muutaman sekunnin, koska kaiken työn tekee oma tietokoneesi.

Jos haluat ensin kirjoittaa tai muokata Markdownia, käytä Markdown-editoria, jossa on reaaliaikainen esikatselu; sen Lisää vientiasetuksia -painike avaa tämän muuntimen valmiiksi tekstilläsi täytettynä. Lisää tekstityökaluja löydät kategoriasta Teksti, esimerkiksi merkki- ja sanalaskurin ja työkalun, jolla voit verrata kahta tekstiä.

Arvostaisin, jos voisit jakaa nämä sivut ystävien kanssa, tallentaa ne kirjanmerkkeihin tai linkittää niihin. Kiitos! 🙏