Markdown converter

Acrafto Team Besedilo
Posodobljeno

Glava front matter na začetku se ne natisne. Njen naslov „Četrtletno poročilo“ je uporabljen kot naslov dokumenta.

Rezultat
Četrtletno poročilo

Ta dokument pokaže, kaj pretvornik ohrani: naslove, sezname, tabele, kodo, citate, povezave in sprotne opombe.1

Poudarki
  • Prihodki so se v primerjavi s prejšnjim četrtletjem povečali za 12 %
  • V septembru sta se ekipi pridružila dva nova sodelavca
  • Vse številke so na strani projekta
Številke
Mesec Naročila Sprememba
Julij 1.240 +4 %
Avgust 1.310 +6 %
September 1.395 +6 %
Naslednji koraki
  1. Dokončaj priročnik za nove sodelavce
  2. Preglej stran s cenami
    • Primerjaj jo s staro različico
    • Prosi podporo za povratne informacije
  3. Načrtuj naslednjo izdajo
  • Zberi podatke
  • Pošlji poročilo

Številke so zaokrožene na cela naročila.

npm run build && npm run deploy

  1. Naslov je vzet iz glave YAML front matter na vrhu, ki se ne natisne. ↩︎

Možnosti

Pretvorite Markdown v PDF, Word, HTML ali navadno besedilo s tem pretvornikom Markdown (Markdown converter), ki deluje kar v vašem brskalniku: prilepite besedilo ali odprite datoteko .md, izberite obliko in prenesite rezultat. Tabele Markdown pretvori tudi v datoteke Excel ali CSV, izdela e-knjige EPUB in dokumente LaTeX, Markdown pa prepiše tudi za sisteme Jira, Confluence in Slack ter za BBCode na forumih. Predogled ob besedilu prikazuje rezultat, medtem ko prilagajate nastavitve. Vaše datoteke se nikamor ne naložijo, registracija ni potrebna, vodnega žiga ni in število strani ni omejeno.

Kako pretvoriti datoteko Markdown

  1. Markdown prilepite v levo polje ali kliknite Odpri datoteke in izberite eno ali več datotek .md. Datoteke lahko spustite tudi na pretvornik.
  2. Obliko izberite v razdelku Pretvori v. V skupini Dokumenti so PDF, Word (DOCX), EPUB, LaTeX, HTML in Besedilo (TXT), v skupini Tabele sta Excel (XLSX) in CSV, v skupini Za aplikacije pa Jira / Confluence, Slack in BBCode.
  3. Preverite predogled v razdelku Rezultat in po želji v razdelku Možnosti spremenite velikost strani, robove, pisavo ali druge nastavitve.
  4. Po potrebi uredite Ime datoteke in kliknite gumb za prenos. Besedilne oblike lahko tudi kopirate neposredno v odložišče, pri oblikah Jira / Confluence, Slack in BBCode pa je kopiranje glavni gumb.

Pretvornik se odpre s primerom četrtletnega poročila, ki ima naslov v glavi front matter, sezname, tabelo z desno poravnanimi števili, seznam opravil, citat, blok kode in sprotno opombo. Pretvorite ga v vsako obliko in poglejte, kako se elementi prikažejo.

Pretvornik Markdown v PDF

PDF se izdela v vašem brskalniku s pravim besedilom, ki ga je mogoče označiti, in ne kot posnetek zaslona strani. Naslovi se v stranskem podoknu bralnika PDF prikažejo kot zaznamki, povezave ostanejo klikljive, povezave na naslove ali sprotne opombe pa skočijo na ustrezno mesto v dokumentu. Tabele ohranijo poravnavo stolpcev in vrstico z glavo ponovijo na vsaki strani, na katero segajo, gnezdeni seznami so oštevilčeni 1., a., i. kot v Wordu, seznami opravil pa dobijo narisana potrditvena polja. Bloki kode uporabljajo pisavo s fiksno širino znakov na svetlo sivem ozadju, zato zamiki ostanejo natanko takšni, kot so zapisani.

V razdelku Možnosti so na voljo nastavitve Velikost strani (A4 ali Letter, prednastavljeno glede na jezik brskalnika), Robovi (ozki 1,27 cm, običajni 2,54 cm ali široki 3,81 cm, torej pol palca, 1 palec ali 1,5 palca), Pisava (serifna ali neserifna), Velikost pisave in Številke strani, s katero določite, ali se številke strani natisnejo. Kazalo vsebine za naslovom doda seznam naslovov s številkami strani.

Pisave so vdelane v PDF, zato je dokument videti enako na vsakem računalniku in tiskalniku. Pokrivajo latinico, cirilico, grščino in vietnamščino ter puščice, matematične znake in simbole, kot so → ≤ ✓ ★. Kitajščina, japonščina, korejščina, arabščina, hebrejščina, tajščina, indijski sistemi pisanja in emodžiji niso vključeni. Če jih dokument uporablja, pretvornik te znake našteje, gumb za prenos pa postane Shrani kot PDF: odpre pogovorno okno za tiskanje v vašem brskalniku, ki uporablja pisave vašega sistema ter arabščino in hebrejščino piše od desne proti levi. Kot tiskalnik izberite Shrani kot PDF in velikost strani, robovi ter pisava iz razdelka Možnosti se ohranijo.

Pretvorba Markdown v Word (DOCX)

Datoteka Word ima pravo strukturo dokumenta in ni le besedilo, ki je samo videti podobno. Naslovi uporabljajo vgrajene sloge od Naslov 1 do Naslov 6, zato jih Word prikaže v podoknu za krmarjenje, ukaz Kazalo vsebine na zavihku Sklici pa z enim klikom izdela stran s kazalom. Seznami so pravi Wordovi seznami, ki ohranijo oštevilčenje, ko dodajate postavke, vsak oštevilčeni seznam se začne znova pri 1 (ali pri številki, ki ste jo napisali), opravila pa dobijo ☐ in ☒. Tabele vrstico z glavo ponovijo na vsaki strani, sprotne opombe postanejo prave Wordove sprotne opombe na dnu strani, povezave na naslove pa skočijo nanje.

Izberite velikost strani, robove, velikost pisave in eno od standardnih pisav Calibri, Cambria, Arial ali Times New Roman. Word datoteko prikaže s pisavo, nameščeno v računalniku, ki jo odpre, zato je predogled tukaj dober približek in ne kopija, natančna do piksla. Datoteka .docx se odpre v programih Microsoft Word, LibreOffice in drugih, ki berejo obliko Office Open XML (v angleščini). Če želite Markdown prenesti v Google Docs, naložite datoteko .docx v Google Drive in jo odprite z Google Docs ali pa besedilo prilepite z gumbom Kopiraj z oblikovanjem v urejevalniku Markdown.

Markdown v HTML

Celotna stran s slogi vam da samostojno datoteko .html z lastnimi čistimi slogi CSS. Deluje brez povezave, sledi svetlemu ali temnemu načinu bralčevega sistema in se lepo natisne. Samo telo strani, za CMS vam da le elemente HTML (<h2>, <p>, <ul>, <table> in tako naprej) brez slogov, pripravljene za lepljenje v WordPress, Ghost, orodje za e-novice ali vašo lastno predlogo. Predogled preklapljajte med zavihkoma Upodobljeno in Koda, da vidite oboje.

HTML sledi specifikacijama CommonMark in GitHub Flavored Markdown (obe v angleščini). Naslovi dobijo atribute id kot na GitHubu, zato povezave, kot je #načrt-izdaje, še naprej delujejo, sprotne opombe pa imajo povezave nazaj na mesto, kjer so bile navedene. Skripte, upravljalniki dogodkov in povezave javascript: se iz neobdelanega HTML v izvornem besedilu odstranijo, zato datoteka Markdown, ki jo je napisal nekdo drug, na vašo stran ne more pretihotapiti kode.

Markdown v navadno besedilo

Besedilo (TXT) odstrani sintakso Markdown in ohrani berljivo strukturo: oznake seznamov postanejo „- “, oštevilčene postavke ohranijo svoje številke, opravila so prikazana kot [ ] in [x], citati se začnejo z „> “, tabele so poravnane v stolpce, sprotne opombe pa so na koncu navedene kot [1], [2]. Ohrani naslove povezav za vsako povezavo v oklepaju zapiše URL, zato se nič ne izgubi, ko besedilo prenesete v e-pošto, polje obrazca ali sistem, ki ne razume Markdowna. Dolžina vrstice lahko dolge vrstice prelomi pri 72 ali 80 znakih za e-pošto v navadnem besedilu.

To je priročno tudi za odgovore orodij za klepet z umetno inteligenco, ki prihajajo v Markdownu: pretvorba v besedilo odstrani zvezdice in znake #, preden jih prilepite drugam.

Tabela Markdown v Excel in CSV

Excel (XLSX) in CSV iz dokumenta vzameta samo tabele, kar je priročno za tabele v datotekah README, dokumentaciji ali odgovorih orodij za klepet z umetno inteligenco. V Excelu vsaka tabela postane svoj list, poimenovan po naslovu nad njo. Števila se shranijo kot prava števila, tudi tista z ločilom tisočic, kot je 1.240, in odstotki, kot je 12 %, zato jih lahko takoj seštevate in razvrščate, vrednosti, kot sta 007 ali poštna številka z ničlo na začetku, pa ostanejo besedilo z ohranjenimi vodilnimi ničlami. Vrstica z glavo je krepka in zamrznjena, vsak list pa dobi filter.

CSV zapiše eno datoteko za vsako tabelo, več tabel pa se zapakira v ZIP. V razdelku Možnosti izberete Ločilo: Excel, nastavljen na jezik z decimalno vejico, kot sta nemščina ali francoščina, pričakuje podpičje, sicer cela vrstica pristane v enem stolpcu. Združljivo z Excelom (UTF-8 z BOM) poskrbi, da Excel pravilno prebere šumnike in druge posebne znake. Gumb Kopiraj tabele postavi tabele v odložišče, da jih lahko prilepite v Excel ali Google Sheets, ne da bi shranili datoteko.

Markdown v zapise Jira, Confluence, Slack in BBCode

Te tri oblike so besedilo za aplikacije, ki ne berejo standardnega Markdowna, zato glavni gumb rezultat kopira:

  • Jira / Confluence zapiše sintakso wiki: naslove h2., *bold*, _italic_, bloke {code}, tabele ||header||, povezave [text|url] in sezname z # ali *. Ta oblika je namenjena sistemoma Jira in Confluence v različici Data Center ali Server ter starejšim poljem, ki še uporabljajo sintakso wiki. Trenutni urejevalnik v Jira Cloud sam bere Markdown, zato lahko tja prilepite izvirno besedilo.
  • Slack zapiše lastno oblikovanje aplikacije Slack: *bold*, _italic_, ~strikethrough~, kodo, citate in povezave [text](url), sezname z znaki za oznake in tabele kot poravnane bloke kode, ker Slack nima tabel. Če želite oblikovanje videti po pošiljanju, v Slacku pod Preferences, Advanced vklopite Format messages with markup. Za bote in webhooke (oblika API) povezave zapiše kot <url|text>, znake &, < in > pa nadomesti z ubežnimi zaporedji, kot pričakuje API Slacka.
  • BBCode uporablja oznake, ki jih razumejo phpBB, vBulletin, XenForo, SMF in MyBB: [b], [i], [u], [s], [url], [img], [quote], [list] in [code]. Naslovi postanejo krepke vrstice, ker se velikosti naslovov od foruma do foruma razlikujejo, tabele pa postanejo poravnani bloki [code].

Markdown v EPUB za e-bralnike in Kindle

EPUB izdela e-knjigo z naslovno stranjo, kazalom vsebine in enim poglavjem za vsak naslov najvišje ravni. Če ima dokument en sam naslov 1, ki je uporabljen kot naslov knjige, se poglavja namesto tega začnejo pri naslovih 2; to lahko izberete z nastavitvijo Delitev na poglavja v razdelku Možnosti. Sprotne opombe so zbrane kot končne opombe s povezavami nazaj v besedilo, slike s spletnim naslovom so vdelane, naslov in avtor iz glave front matter pa se prikažeta v podatkih o knjigi.

Datoteke uspešno prestanejo preverjanje z EPUBCheck (v angleščini), uradnim validatorjem formata EPUB, zato se odprejo v Apple Books, Kobo, Google Play Books in Calibre. Amazonova storitev Send to Kindle prav tako sprejme EPUB in ga pretvori za vaš Kindle, Kindle Direct Publishing pa sprejema rokopise v formatu EPUB, pri čemer se naslovnica naloži posebej.

Markdown v LaTeX

LaTeX izdela celoten dokument article, ki naloži samo potrebne pakete, z nastavitvijo Samo vsebina, za lepljenje v dokument pa le vsebino za članek, ki ga že imate, na primer v storitvi Overleaf. Naslovi postanejo \section in \subsection, seznami itemize in enumerate, tabele tabular z ohranjeno poravnavo stolpcev, koda gre v verbatim, sprotne opombe postanejo pravi ukazi \footnote, povezave pa uporabljajo \href. Znaki, ki jih LaTeX obravnava kot ukaze, na primer %, $, &, # in _, so zapisani z ubežnimi zaporedji. LaTeX ne more naložiti slik s spleta, zato vsaka slika postane vrstica \includegraphics z imenom datoteke in izvirnim naslovom v komentarju; sliko prenesite v isto mapo kot datoteko .tex. Prevedite s programom pdfLaTeX, za nelatinične pisave pa z XeLaTeX ali LuaLaTeX.

Pretvorba več datotek .md hkrati

Odprite ali spustite več datotek in pod besedilnim poljem se prikaže seznam. Uredi naloži datoteko v polje, da jo lahko preverite ali popravite, Odstrani jo vzame iz paketa, Prenesi vse kot ZIP pa vsako datoteko pretvori v izbrano obliko z enakimi nastavitvami. Vsaka datoteka ohrani svoje ime, tako da notes.md postane notes.pdf. Datoteke, ki niso besedilne, na primer slike, so izpuščene z obvestilom.

Front matter, slike in imena datotek

Mnoge datoteke Markdown se začnejo z blokom YAML front matter (v angleščini) med dvema vrsticama ---, kakršnega uporabljajo Jekyll, Hugo, Obsidian in druga orodja. Pretvornik ga ne natisne. Njegov title postane naslov dokumenta v lastnostih PDF in Word ter v elementu HTML <title>, pa tudi predlagano ime datoteke; author postane avtor. Če front matter ni, datoteko poimenuje prvi naslov najvišje ravni.

Slike s polnim spletnim naslovom prenese vaš brskalnik in jih vdela v PDF in datoteko Word, če strežnik, ki jih gosti, to dovoli (CORS, v angleščini). Slike GIF, WebP in SVG se pri tem pretvorijo v PNG.

Pogosta vprašanja

Ali se moje datoteke Markdown naložijo na strežnik?

Ne. Branje datotek, izdelava dokumentov PDF in Word ter pakiranje v ZIP potekajo v vašem brskalniku, zato zasebni zapiski in interna dokumentacija nikoli ne zapustijo vašega računalnika. Pretvornik si zapomni samo vaše nastavitve, kot sta oblika in velikost strani, ne pa besedila.

Zakaj v mojem PDF manjkajo slike?

Slik, zapisanih kot pot v vašem računalniku, na primer images/chart.png, spletna stran ne more prebrati, zato jih nadomesti njihov opis. Uporabite polni naslov https ali sliko najprej objavite na spletu. Nekatera spletna mesta drugim stranem tudi ne dovolijo nalaganja svojih slik; tudi v tem primeru se uporabi opis, pretvornik pa vam pove, koliko slik ni mogel naložiti.

Ali lahko Markdown s kitajskim, japonskim ali arabskim besedilom pretvorim v PDF?

Da, prek brskalnika. Pisave, vgrajene v PDF, teh sistemov pisanja ne vsebujejo, zato gumb za prenos pri takem dokumentu postane Shrani kot PDF in odpre pogovorno okno za tiskanje, kjer kot tiskalnik izberete Shrani kot PDF. Brskalnik uporabi pisave vašega sistema, besedilo ostane označljivo, arabščina in hebrejščina pa tečeta od desne proti levi. Tudi Word (DOCX) in HTML ohranita vse znake.

Ali podpira matematične formule LaTeX ali diagrame Mermaid?

Ne. Formule, zapisane med znaki za dolar, ostanejo navadno besedilo, blok Mermaid pa se pretvori kot vsak drug blok kode. Tabele, seznami opravil, sprotne opombe, koda in vse drugo iz GitHub Flavored Markdown so podprti v vseh oblikah.

Ali lahko Word ali Google Docs pretvorim v Markdown?

Da, z urejevalnikom Markdown: prilepite besedilo, kopirano iz Worda, Google Docs ali s spletne strani, in njegovo oblikovanje se spremeni v Markdown, vključno z naslovi, seznami, povezavami in tabelami. Pretvorba PDF nazaj v Markdown ni podprta, ker PDF hrani besedilo, razporejeno po strani, in ne naslovov, seznamov in tabel.

Kako pretvorim tabelo Markdown v Excel?

Prilepite Markdown s tabelo, izberite Excel (XLSX) in prenesite datoteko. Vsaka tabela postane list, števila pa so shranjena kot števila. Če potrebujete samo vrednosti v preglednici, ki jo že imate odprto, kliknite Kopiraj tabele in jih prilepite v Excel ali Google Sheets.

Zakaj Excel celotno vrstico CSV postavi v en stolpec?

Excel datoteko CSV razdeli glede na ločilo seznama v vašem sistemu. V jezikih, ki decimalna števila pišejo z vejico, kot so slovenščina, nemščina ali francoščina, je to ločilo podpičje. V polju Ločilo izberite Podpičje in datoteko prenesite znova. Če so šumniki ali drugi posebni znaki prikazani napačno, pustite vklopljeno možnost Združljivo z Excelom (UTF-8 z BOM).

Ali lahko EPUB pošljem na svoj Kindle?

Da. Amazonova storitev Send to Kindle, bodisi po e-pošti, v aplikaciji Kindle ali na spletnem mestu Send to Kindle, sprejme datoteke EPUB in jih pretvori za knjižnico Kindle. Tudi Kindle Direct Publishing sprejme EPUB, če želite knjigo izdati.

Ali Jira Cloud še uporablja sintakso wiki?

V trenutnem urejevalniku ne, saj ta bere Markdown in ga med lepljenjem ali tipkanjem spremeni v oblikovanje. Oblika Jira / Confluence je namenjena sistemoma Jira in Confluence v različici Data Center ali Server ter starejšim poljem, ki še prikazujejo sintakso wiki. V Jira Cloud lahko namesto tega prilepite izvirni Markdown.

Ali lahko datoteko LaTeX odprem v Overleafu?

Da. Ustvarite nov prazen projekt, naložite datoteko .tex ali prilepite njeno vsebino in naložite vse slike, ki jih omenja. Z nastavitvijo Samo vsebina, za lepljenje v dokument dobite le vsebino za projekt, ki že ima svojo preambulo.

Kako Markdown pretvorim v PDF ali Word iz ukazne vrstice?

Običajno orodje za to je Pandoc (v angleščini): pandoc notes.md -o notes.docx takoj ustvari datoteko Word, za izhod PDF pa mora biti nameščen še pogon LaTeX. Ta stran ne zahteva namestitve in najprej pokaže predogled, kar je preprostejše za en dokument ali hitro paketno pretvorbo.

Ali obstaja omejitev velikosti datoteke ali števila strani?

Vsaka datoteka ima lahko do 20 MB besedila, kar je veliko več od katerega koli običajnega dokumenta, omejitve števila strani in vodnega žiga pa ni. Izdelava zelo dolgih dokumentov z veliko slikami traja nekaj sekund, ker vse delo opravi vaš računalnik.

Če želite Markdown najprej napisati ali urediti, uporabite urejevalnik Markdown s sprotnim predogledom; njegov gumb Več možnosti izvoza odpre ta pretvornik z že vnesenim besedilom. Več orodij za besedilo je v kategoriji Besedilo, na primer števec besed in znakov in orodje za primerjavo dveh besedil.

Cenil bi, če bi te strani delili s prijatelji, jih dodali med zaznamke ali nanje povezali. Hvala! 🙏