Markdowni konverter
Ülaosas olevat front matter plokki ei prindita. Selle pealkirja „Kvartaliaruanne“ kasutatakse dokumendi pealkirjana.
See dokument näitab, mida konverter säilitab: pealkirjad, loendid, tabelid, kood, tsitaadid, lingid ja allmärkused.1
- Tulu kasvas eelmise kvartaliga võrreldes 12 %
- Meeskonnaga liitus septembris kaks uut liiget
- Projekti lehel on kõik arvud
| Kuu | Tellimused | Muutus |
|---|---|---|
| Juuli | 1 240 | +4 % |
| August | 1 310 | +6 % |
| September | 1 395 | +6 % |
- Lõpeta uue töötaja sisseelamisjuhend
- Vaata hinnakirja leht üle
- Võrdle vana versiooniga
- Küsi klienditoelt tagasisidet
- Planeeri järgmine väljalase
- Kogu andmed kokku
- Saada aruanne
Tellimuste arvud on ümardatud täisarvuni.
npm run build && npm run deploy
-
Pealkiri pärineb ülaosas olevast YAML front matter plokist, mida ei prindita. ↩︎
Valikud
Teisendage Markdown PDF-iks, Wordiks, HTML-iks või lihttekstiks selle Markdowni konverteriga, mis töötab otse teie brauseris: kleepige tekst või avage .md-fail, valige vorming ja laadige tulemus alla. See muudab ka Markdowni tabelid Exceli- või CSV-failideks, koostab EPUB-vormingus e-raamatuid ja LaTeX-dokumente ning kirjutab Markdowni ümber Jira, Confluence’i, Slacki ja foorumite BBCode’i jaoks. Teksti kõrval olev eelvaade näitab tulemust juba seadete muutmise ajal. Teie faile ei laadita kuhugi üles, registreeruda pole vaja ning vesimärki ega lehekülgede piirangut pole.
Kuidas Markdowni faili teisendada
- Kleepige Markdown vasakule väljale või klõpsake Ava failid ja valige üks või mitu .md-faili. Faile võite ka konverterile lohistada.
- Valige vorming jaotises Teisenda vormingusse. Rühmas Dokumendid on PDF, Word (DOCX), EPUB, LaTeX, HTML ja Tekst (TXT), rühmas Tabelid on Excel (XLSX) ja CSV ning rühmas Rakendustele on Jira / Confluence, Slack ja BBCode.
- Kontrollige eelvaadet Tulemus ja soovi korral muutke jaotises Valikud lehe suurust, veeriseid, fonti või muid seadeid.
- Vajaduse korral muutke välja Failinimi ja klõpsake allalaadimisnuppu. Tekstivorminguid saab ka otse lõikelauale kopeerida ning Jira, Slacki ja BBCode’i puhul on kopeerimine põhinupp.
Konverteris on alguses näidiseks kvartaliaruanne, millel on front matter plokis pealkiri, loendid, paremale joondatud arvudega tabel, ülesannete loend, tsitaat, koodiplokk ja allmärkus. Teisendage see igasse vormingusse, et näha, milliseks elemendid kujunevad.
Markdown PDF-iks
PDF koostatakse teie brauseris päris, valitava tekstiga, mitte lehe ekraanipildina. Pealkirjad ilmuvad PDF-lugeja külgpaneelil järjehoidjatena, lingid jäävad klõpsatavaks ning lingid pealkirjadele või allmärkustele viivad dokumendi sees õigesse kohta. Tabelid säilitavad veergude joonduse ja kordavad päiserida igal leheküljel, kuhu nad ulatuvad, pesastatud loendid nummerdatakse 1., a., i. nagu Wordis ja ülesannete loendid saavad joonistatud märkeruudud. Koodiplokid kasutavad fikseeritud laiusega fonti helehallil taustal, nii et taanded jäävad täpselt selliseks, nagu need kirjutati.
Jaotises Valikud saate määrata järgmist: Lehe suurus (A4 või Letter, eelvalitud teie brauseri keele järgi), Veerised (kitsad 1,27 cm, tavalised 2,54 cm või laiad 3,81 cm ehk 0,5, 1 või 1,5 tolli), Font (seriifidega või seriifideta), Fondi suurus ja Leheküljenumbrid (kas need prinditakse). Sisukord lisab pärast pealkirja pealkirjade loendi koos leheküljenumbritega.
Fondid on PDF-i sisse põimitud, nii et see näeb igas arvutis ja printeris ühesugune välja. Need katavad ladina, kirillitsa, kreeka ja vietnami kirja ning nooled, matemaatilised märgid ja sümbolid nagu → ≤ ✓ ★. Hiina, jaapani, korea, araabia, heebrea ja tai kiri, India kirjad ning emojid pole kaasatud. Kui dokument neid kasutab, nimetab konverter need märgid ja allalaadimisnupu asemele tuleb nupp Salvesta PDF-ina: see avab teie brauseri printimisdialoogi, mis kasutab teie süsteemi fonte ning kirjutab araabia ja heebrea teksti paremalt vasakule. Valige printeriks Salvesta PDF-ina ning jaotises Valikud määratud lehe suurus, veerised ja font säilivad.
Teisenda Markdown Wordiks (DOCX)
Wordi failil on päris dokumendistruktuur, see pole lihtsalt sarnase välimusega tekst. Pealkirjad kasutavad Wordi sisseehitatud pealkirjalaade 1 kuni 6, nii et Wordi navigeerimispaan loetleb need ja vahekaardi Viited nupp Sisukord koostab sisukorra ühe klõpsuga. Loendid on päris Wordi loendid, mis säilitavad nummerduse, kui punkte lisate, iga nummerdatud loend algab uuesti 1-st (või teie kirjutatud numbrist) ning ülesannete punktid saavad märgid ☐ ja ☒. Tabelid kordavad päiserida igal leheküljel, allmärkustest saavad päris Wordi allmärkused lehekülje allservas ja lingid pealkirjadele viivad nende juurde.
Valige lehe suurus, veerised, fondi suurus ja üks standardfontidest Calibri, Cambria, Arial või Times New Roman. Word näitab faili fondiga, mis on paigaldatud seda avavasse arvutisse, nii et siinne eelvaade annab hea ettekujutuse, kuid pole pikslitäpne koopia. Fail .docx avaneb Microsoft Wordis, LibreOffice’is ja teistes programmides, mis loevad vormingut Office Open XML (inglise keeles). Markdowni viimiseks Google Docsi laadige .docx üles Google Drive’i ja avage see Google Docsiga või kleepige tekst Markdowni redaktorist nupuga Kopeeri vormindatud tekstina.
Markdown HTML-iks
Täielik leht koos stiilidega annab eraldiseisva .html-faili, millel on oma puhas stiilileht. See töötab võrguühenduseta, järgib lugeja süsteemi heledat või tumedat režiimi ja sobib hästi printimiseks. Ainult sisu, CMS-i jaoks annab ainult HTML-elemendid (<h2>, <p>, <ul>, <table> jne) ilma stiilideta, valmis kleepimiseks WordPressi, Ghosti, uudiskirjade tööriista või teie enda malli. Lülitage eelvaade vaadete Renderdatud ja Kood vahel, et näha mõlemat poolt.
HTML järgib standardeid CommonMark ja GitHub Flavored Markdown (mõlemad inglise keeles). Pealkirjad saavad id-atribuudid nagu GitHubis, nii et lingid kujul #väljalaskeplaan töötavad edasi, ja allmärkustel on lingid tagasi kohta, kus neile viidati. Lähteteksti toor-HTML-ist eemaldatakse skriptid, sündmuste käsitlejad ja javascript:-lingid, nii et kellegi teise Markdowni fail ei saa teie lehele koodi sokutada.
Markdown lihttekstiks
Tekst (TXT) eemaldab Markdowni süntaksi ja hoiab struktuuri loetavana: täppidest saab „- “, nummerdatud punktid säilitavad numbrid, ülesanded kuvatakse kujul [ ] ja [x], tsitaadid algavad märkidega „> “, tabelid joondatakse veergudesse ja allmärkused loetletakse lõpus kujul [1], [2]. Säilita lingiaadressid kirjutab iga lingi järele URL-i sulgudes, nii et midagi ei lähe kaduma, kui tekst läheb e-kirja, vormivälja või süsteemi, mis Markdowni ei mõista. Rea pikkus võib murda pikad read 72 või 80 märgi järel lihttekstiga e-kirjade jaoks.
See on mugav ka tehisintellekti vestlusrobotite vastuste puhul, mis tulevad Markdownis: tekstiks teisendamine eemaldab tärnid ja trellid enne, kui need mujale kleebite.
Markdowni tabel Excelisse ja CSV-sse
Excel (XLSX) ja CSV võtavad dokumendist ainult tabelid, mis on mugav README-failide, dokumentatsiooni või tehisintellekti vestlusrobotite vastuste tabelite puhul. Excelis saab igast tabelist eraldi leht, mille nimi võetakse tabeli kohal olevast pealkirjast. Arvud salvestatakse päris arvudena, ka tuhandete eraldajaga arvud nagu 1 240 ja protsendid nagu 12 %, nii et saate neid kohe summeerida ja sortida, samas kui väärtused nagu 007 või postiindeks säilitavad algusnullid tekstina. Päiserida on paks ja külmutatud ning igal lehel on filter.
CSV kirjutab iga tabeli kohta ühe faili ja mitu tabelit pakitakse ZIP-faili. Jaotises Valikud valite Eraldaja: kümnendkomaga keelele, näiteks saksa või prantsuse keelele seatud Excel ootab semikoolonit, muidu satub kogu rida ühte veergu. Exceliga ühilduv (UTF-8 koos BOM-iga) paneb Exceli täpitähti ja muid märke õigesti lugema. Kopeeri tabelid paneb tabelid lõikelauale, nii et saate need Excelisse või Google Sheetsi kleepida ilma faili salvestamata.
Markdown Jira, Confluence’i, Slacki ja BBCode’i jaoks
Need kolm vormingut on tekst rakendustele, mis standardset Markdowni ei loe, seega kopeerib põhinupp tulemuse:
- Jira / Confluence kirjutab vikimärgistust: pealkirjad
h2.,*bold*,_italic_, koodiplokid{code}, tabelid||header||, lingid[text|url]ning loendid#või*. See on mõeldud Jira ja Confluence Data Centeri või Serveri jaoks ning vanemate väljade jaoks, mis kasutavad endiselt vikimärgistust. Jira Cloudi praegune redaktor loeb Markdowni ise, nii et seal saate kleepida algse teksti. - Slack kirjutab Slacki oma märgistust:
*bold*,_italic_,~strikethrough~, kood, tsitaadid ja lingid[text](url), loendid täpimärkidega ja tabelid joondatud koodiplokkidena, sest Slackis tabeleid pole. Vorminduse nägemiseks pärast saatmist lülitage Slackis sisse Format messages with markup (Preferences, Advanced). Bottidele ja webhookidele (API-vorming) kirjutab lingid kujul<url|text>ja asendab märgid&,<ja>olemitega, nagu Slacki API eeldab. - BBCode kasutab silte, mida mõistavad phpBB, vBulletin, XenForo, SMF ja MyBB:
[b],[i],[u],[s],[url],[img],[quote],[list]ja[code]. Pealkirjadest saavad paksus kirjas read, sest pealkirjade suurused on foorumiti erinevad, ja tabelitest saavad joondatud[code]plokid.
Markdown EPUB-iks e-lugerite ja Kindle’i jaoks
EPUB koostab e-raamatu, millel on tiitelleht, sisukord ja iga ülemise taseme pealkirja kohta üks peatükk. Kui dokumendis on ainult üks 1. taseme pealkiri, mida kasutatakse raamatu pealkirjana, algavad peatükid hoopis 2. taseme pealkirjadest; seda saate muuta jaotise Valikud sättega Peatükkide jaotus. Allmärkused kogutakse lõpumärkusteks koos linkidega tagasi teksti, veebiaadressiga pildid põimitakse raamatusse ning front matter ploki pealkiri ja autor ilmuvad raamatu andmetes.
Failid läbivad ametliku EPUB-i validaatori EPUBCheck (inglise keeles) kontrolli, nii et need avanevad Apple Booksis, Kobos, Google Play Booksis ja Calibres. Amazoni Send to Kindle võtab samuti EPUB-faile vastu ja teisendab need teie Kindle’i jaoks ning Kindle Direct Publishing võtab vastu EPUB-käsikirju, kusjuures kaanepilt laaditakse üles eraldi.
Markdown LaTeX-iks
LaTeX loob täieliku article-dokumendi, mis laadib ainult vajalikud paketid, või valikuga Ainult sisu, dokumenti kleepimiseks ainult sisu dokumendi jaoks, mis teil juba olemas on, näiteks Overleafis. Pealkirjadest saavad \section ja \subsection, loenditest itemize ja enumerate, tabelitest tabular koos veergude joondusega, kood läheb keskkonda verbatim, allmärkustest saavad päris \footnote-käsud ja lingid kasutavad käsku \href. Märgid, mida LaTeX käsitleb käskudena, näiteks %, $, &, # ja _, kirjutatakse paojadadena. LaTeX ei saa veebist pilte laadida, seega saab igast pildist \includegraphics-rida, milles on faili nimi ja kommentaaris algne aadress; laadige pilt alla .tex-faili kõrvale. Kompileerige pdfLaTeX-iga või muu kui ladina kirja puhul XeLaTeX-i või LuaLaTeX-iga.
Mitme .md-faili teisendamine korraga
Avage või lohistage mitu faili ja tekstivälja alla ilmub loend. Muuda laadib faili tekstivälja, et saaksite seda kontrollida või parandada, Eemalda võtab selle pakist välja ja Laadi kõik alla ZIP-failina teisendab iga faili valitud vormingusse samade seadetega. Iga fail säilitab oma nime, nii et failist notes.md saab notes.pdf. Failid, mis pole tekst, näiteks pildid, jäetakse teatega vahele.
Front matter, pildid ja failinimed
Paljud Markdowni failid algavad kahe --- rea vahel oleva YAML-plokiga, mida nimetatakse front matter (inglise keeles) ja mida kasutavad Jekyll, Hugo, Obsidian ja teised tööriistad. Konverter seda ei prindi. Selle väljast title saab dokumendi pealkiri PDF-i ja Wordi atribuutides ning HTML-i sildis <title> ja ka soovitatav failinimi; väljast author saab autor. Kui front matter plokki pole, annab failile nime esimene ülemise taseme pealkiri.
Täieliku veebiaadressiga pildid laadib alla teie brauser ja need põimitakse PDF- ja Wordi-faili, kui neid majutav server seda lubab (CORS, inglise keeles). GIF-, WebP- ja SVG-pildid teisendatakse seejuures PNG-ks.
Korduma kippuvad küsimused
Kas mu Markdowni failid laaditakse serverisse üles?
Ei. Failide lugemine, PDF- ja Wordi-dokumentide koostamine ning ZIP-faili pakkimine toimuvad teie brauseris, nii et privaatsed märkmed ja sisedokumentatsioon ei lahku kunagi teie arvutist. Konverter jätab meelde ainult teie seaded, näiteks vormingu ja lehe suuruse, mitte teksti.
Miks mu PDF-ist puuduvad pildid?
Pilte, mis on kirjutatud teie arvutis asuva teena, näiteks images/chart.png, ei saa veebileht lugeda; need asendatakse nende kirjeldusega. Kasutage täielikku https-aadressi või pange pilt kõigepealt veebi. Mõned veebisaidid keelavad ka teistel saitidel oma pilte laadida; sel juhul kasutatakse samuti kirjeldust ja konverter ütleb, mitu pilti tal laadida ei õnnestunud.
Kas saan hiina, jaapani või araabia tekstiga Markdowni PDF-iks teisendada?
Jah, teie brauseri kaudu. PDF-i sisseehitatud fondid neid kirjasüsteeme ei sisalda, seega muutub sellise dokumendi puhul allalaadimisnupp nupuks Salvesta PDF-ina ja avab printimisdialoogi, kus valite printeriks Salvesta PDF-ina. Brauser kasutab teie süsteemi fonte, tekst jääb valitavaks ning araabia või heebrea tekst kulgeb paremalt vasakule. Ka Word (DOCX) ja HTML säilitavad kõik märgid.
Kas see toetab LaTeX-i valemeid või Mermaidi diagramme?
Ei. Dollarimärkide vahele kirjutatud valemid jäävad lihttekstiks ja Mermaidi plokk teisendatakse nagu iga teine koodiplokk. Tabeleid, ülesannete loendeid, allmärkusi, koodi ja kõike muud GitHub Flavored Markdownist toetatakse igas vormingus.
Kas saan Wordi või Google Docsi dokumendi Markdowniks teisendada?
Jah, Markdowni redaktoriga: kleepige Wordist, Google Docsist või veebilehelt kopeeritud tekst ja selle vormindus muutub Markdowniks, kaasa arvatud pealkirjad, loendid, lingid ja tabelid. PDF-i tagasi Markdowniks teisendamist ei toetata, sest PDF salvestab lehele paigutatud teksti, mitte pealkirju, loendeid ja tabeleid.
Kuidas Markdowni tabelit Excelisse teisendada?
Kleepige tabeliga Markdown, valige Excel (XLSX) ja laadige fail alla. Igast tabelist saab leht, kus arvud on salvestatud arvudena. Kui vajate väärtusi ainult juba avatud arvutustabelis, klõpsake Kopeeri tabelid ja kleepige Excelisse või Google Sheetsi.
Miks paneb Excel kogu CSV rea ühte veergu?
Excel jagab CSV-faili teie süsteemi loendieraldaja järgi. Keeltes, kus kümnendmurde kirjutatakse komaga, näiteks saksa, prantsuse, tšehhi või eesti keeles, on see eraldaja semikoolon. Valige jaotises Eraldaja väärtus Semikoolon ja laadige fail uuesti alla. Kui täpitähed näevad valed välja, hoidke valik Exceliga ühilduv (UTF-8 koos BOM-iga) sisse lülitatuna.
Kas saan EPUB-i oma Kindle'isse saata?
Jah. Amazoni Send to Kindle võtab e-posti, Kindle'i rakenduse või Send to Kindle veebisaidi kaudu vastu EPUB-faile ja teisendab need Kindle'i raamatukogu jaoks. Ka Kindle Direct Publishing võtab EPUB-faile vastu, kui soovite raamatu avaldada.
Kas Jira Cloud kasutab endiselt vikimärgistust?
Praeguses redaktoris mitte: see loeb Markdowni ja muudab selle kleepimise või kirjutamise ajal vorminduseks. Vorming Jira / Confluence on mõeldud Jira ja Confluence Data Centeri või Serveri jaoks ning vanemate väljade jaoks, mis näitavad endiselt vikimärgistust. Jira Cloudis võite selle asemel kleepida algse Markdowni.
Kas saan LaTeX-faili Overleafis avada?
Jah. Looge uus tühi projekt, laadige üles .tex-fail või kleepige selle sisu ning laadige üles kõik pildid, mida see mainib. Valikuga Ainult sisu, dokumenti kleepimiseks saate ainult sisu projekti jaoks, millel on juba oma preambul.
Kuidas teisendada Markdown PDF-iks või Wordiks käsurealt?
Tavaline tööriist on Pandoc (inglise keeles): pandoc notes.md -o notes.docx loob kohe Wordi faili, PDF-i jaoks on aga vaja lisaks paigaldada LaTeX-mootor. See leht ei vaja paigaldamist ja näitab kõigepealt eelvaadet, mis on mugavam ühe dokumendi või väikese failipaki puhul.
Kas failisuurusel või lehekülgede arvul on piirang?
Igas failis võib olla kuni 20 MB teksti, mis on palju rohkem kui üheski tavalises dokumendis, ning lehekülgede piirangut ega vesimärki pole. Väga pikkade ja paljude piltidega dokumentide koostamine võtab mõne sekundi, sest kogu töö teeb teie enda arvuti.
Markdowni kirjutamiseks või muutmiseks kasutage reaalajas eelvaatega Markdowni redaktorit; redaktori nupp Rohkem ekspordivalikuid avab selle konverteri, kuhu tekst on juba sisestatud. Rohkem tekstitööriistu leiate kategooriast Tekst, näiteks sõnade ja märkide loenduri ning tööriista kahe teksti võrdlemiseks.