Markdowni redaktor

See Markdowni redaktor (Markdown editor online) töötab otse brauseris: vasakul näete oma teksti ja paremal vormindatud tulemust, mis uueneb iga klahvivajutusega. See mõistab Markdowni, mida kasutatakse GitHubis, README-failides, vikides ja märkmerakendustes nagu Obsidian: pealkirju, loendeid, ülesannete loendeid, tabeleid, koodi, tsitaate, linke, pilte ja allmärkusi. Kontot pole vaja ja midagi teie kirjutatust ei saadeta kuhugi.

Kuidas Markdowni redaktorit online kasutada

1. Sisestage või kleepige Markdown vasakule väljale või avage .md-fail tööriistariba failinupuga. Faili võite lohistada ka redaktori suvalisse kohta.
2. Jälgige eelvaadet paremal. Sünkroonne kerimine hoiab mõlemad pooled dokumendi samas kohas, ükskõik kumba poolt te kerite.
3. Vormindage teksti tööriistariba või kiirklahvidega, näiteks Ctrl+B paksu kirja ja Ctrl+K lingi jaoks.
4. Kopeerige tulemus Markdownina, HTML-ina või vormindatud tekstina või laadige see alla .md-, .pdf-, .docx-, .html- või .txt-failina.

Redaktor avaneb lühikese näidisega „Projekti märkmed“, mis kasutab kõiki levinud elemente, nii et näete süntaksit ja selle tulemust kõrvuti enne, kui hakkate ise kirjutama.

Markdowni redaktor reaalajas eelvaatega

Redaktori kohal on kolm vaadet. Kõrvuti paigutab Markdowni ja eelvaate teineteise kõrvale, Kirjuta annab kogu laiuse tekstile ja Eelvaade näitab ainult tulemust, nii et see toimib lihtsa Markdowni vaaturina faili jaoks, mille keegi teile saatis. Telefonis lülitub redaktor vaadete Kirjuta ja Eelvaade vahel, sest kaks veergu oleksid lugemiseks liiga kitsad.

Eelvaade kuvatakse nii, nagu GitHub Markdowni kuvab: CommonMark koos GitHub Flavored Markdowni laiendustega (mõlemad inglise keeles), mis lisavad tabelid, ülesannete loendid, läbikriipsutuse ja automaatsed lingid. Pealkirjad saavad ankrud nagu GitHubis, nii et pealkirjale ## Väljalaskeplaan saab viidata lingiga #väljalaskeplaan, ja sellisel lingil klõpsamine kerib eelvaate pealkirjani. Kujul [^1] kirjutatud allmärkused nummerdatakse selles järjekorras, milles neid esimest korda mainite, ja loetletakse lõpus.

Tekstiväli kasutab teie brauseri õigekirjakontrolli, nii et valesti kirjutatud sõnad joonitakse kirjutamise ajal alla. Redaktori all näete sõnade ja märkide arvu ning lugemisaega. Loendamisel jäetakse Markdowni süntaks välja, nii et märkidega ## tähistatud pealkirjas loetakse ainult selle sõnu. Lausete ja lõikude loendamiseks kleepige tekst sõnade ja märkide loendurisse.

Tööriistariba ja kiirklahvid

Tööriistaribal on kõik, mida tavaline dokument vajab: Pealkiri, Paks, Kursiiv, Läbikriipsutus, Reasisene kood, Link, Pilt, Tsitaat, Koodiplokk, Täpploend, Nummerdatud loend, Ülesannete loend, Tabel ja Horisontaaljoon. Kui valite kõigepealt teksti, ümbritseb nupp selle märgenditega; sama nupu uuesti vajutamine eemaldab märgendid. Kui midagi pole valitud, lisab nupp lühikese kohatäiteteksti, mis on juba valitud, nii et saate selle lihtsalt üle kirjutada.

Mõni detail säästab aega:

• Pealkiri muudab praeguse rea järjest kujule #, ##, ### ja tagasi tavaliseks tekstiks.
• Link muudab valitud sõnad kujule [sõnad](https://) ja valib aadressi osa, nii et saate URL-i kohe kleepida. Kui valite hoopis URL-i, saab sellest aadress.
• Loendinupud ja Tsitaat toimivad korraga kõigil valitud ridadel. Kui klõpsate täpploendis nupul Nummerdatud loend, muutub see nummerdatud loendiks.
• Kui vajutate loendipunkti lõpus Enterit, algab järgmine punkt õige märgiga. Numbrid suurenevad, uus ülesanne algab märkimata kastiga ja Enter tühjal punktil lõpetab loendi. Tab ja Shift+Tab suurendavad ja vähendavad loendipunktide taanet.
• Iga nupu või kiirklahviga tehtud muudatuse saab tagasi võtta klahvidega Ctrl+Z.

Kõik kiirklahvid on loetletud redaktori all jaotises Kiirklahvid. Macis kasutatakse neis klahvi Command.

Wordist või Google Docsist kleebitud tekst muutub Markdowniks

Kui kleebite Wordist, Google Docsist või veebilehelt kopeeritud teksti, muudab redaktor selle vorminduse Markdowniks, selle asemel et seda ära visata. Pealkirjadest saavad #-ga algavad read, paks ja kursiivtekst saavad oma tärnid, lingid säilitavad aadressid, täpp- ja nummerdatud loenditest (ka Wordi mitmetasemelistest loenditest) saavad Markdowni loendid ja tabelitest Markdowni tabelid, mille esimene rida on päiserida. Nii viite olemasoleva dokumendi kõige kiiremini README-faili või vikilehele.

Kui soovisite paljast teksti, klõpsake pärast kleepimist ilmuvas teates nupul Kasuta hoopis lihtteksti või kleepige klahvidega Ctrl+Shift+V. VS Code’ist või muust koodiredaktorist kopeeritud kood ning tekst, mis on juba Markdown, kleebitakse täpselt sellisena, nagu see on.

Markdowni süntaksi spikker

Levinuim süntaks ühe pilguga. Sisestage vasaku veeru sisu redaktorisse ja näete eelvaates parema veeru tulemust.

Kirjutate	Saate
# Pealkiri, ## Jaotis, ### Alajaotis	pealkirjad tasemetel 1 kuni 3 (märkidega ###### kuni 6)
**paks** ja *kursiiv*	paks ja kursiiv
~~vana~~	vana
`kood`	kood fikseeritud laiusega kirjas
[tekst](https://example.com)	link
	pilt
- punkt või 1. punkt	täpp- või nummerdatud loend
- [ ] ülesanne ja - [x] tehtud	ülesannete loend märkeruutudega
> tsiteeritud tekst	tsitaat
kolm tagurpidi ülakoma eraldi real enne ja pärast koodi	koodiplokk
--- eraldi real	horisontaaljoon
tekst[^1] ja [^1]: märkus	allmärkus

Markdowni tabelil peab olema päiserida, kriipsudest eraldusrida ja seejärel üks rida iga tabelirea kohta, lahtrid on eraldatud märgiga |. Eraldusreas olev koolon määrab joonduse: :-- joondab vasakule, :-: keskele ja --: paremale. Nupp Tabel lisab valmis kolmeveerulise tabeli, millest alustada. Lahtrid ei pea lähtetekstis kohakuti olema, kuid kohakuti seatud tabelit on hiljem lihtsam muuta.

Markdown lubab kasutada ka HTML-i asjade jaoks, millele tal oma süntaksit pole, näiteks <kbd>Ctrl</kbd> klahvide jaoks, <sub> ja <sup> kirjutamaks H₂O ja x² või <details> jaotise jaoks, mis avaneb klõpsamisel. Skriptid, stiilid ja vormid eemaldatakse eelvaatest turvalisuse huvides.

Kopeeri vormindatud tekstina või laadi fail alla

Kopeeri Markdown kopeerib lähteteksti, Kopeeri HTML kopeerib puhta HTML-i, mis on valmis veebisaidi või CMS-i jaoks, ja Kopeeri vormindatud tekstina kopeerib vormindatud tulemuse. Kleepige see Google Docsi, Wordi, Outlooki või Gmaili ning pealkirjad, paks tekst, loendid, lingid ja tabelid jõuavad kohale vormindatuna, ilma Markdowni sümboliteta.

Nupud Laadi alla salvestavad dokumendi ühe klõpsuga Markdowni-, PDF-, Wordi-, HTML- või lihttekstifailina, mille nimi võetakse front matter ploki pealkirjast või esimesest pealkirjast. Need kasutavad mõistlikke vaikeseadeid: A4-paber (Letter USA-s, Kanadas, Mehhikos ja teistes riikides, kus see on standard), tavalised veerised ja 11-punktine tekst. Lehe suuruse, fontide ja veeriste valimiseks, sisukorra lisamiseks või mitme faili korraga teisendamiseks kasutage nuppu Rohkem ekspordivalikuid, mis avab Markdowni konverteri, kuhu teie tekst on juba sisestatud.

Korduma kippuvad küsimused

Kas mu tekst laaditakse kuhugi üles või salvestatakse?

Ei. Eelvaade, teisendamine ja allalaadimine toimuvad teie brauseris ning teksti ei saadeta kunagi serverisse. Vaikimisi ei salvestata ka midagi, nii et vahekaardi sulgemisel on tekst kadunud. Kui märgite valiku Säilita mustand selles brauseris, salvestatakse tekst pärast iga muudatust teie enda brauseri salvestusruumi ja see ilmub järgmisel külastusel tagasi. Ühisarvutis eemaldage märge, mis kustutab ka salvestatud mustandi.

Kuidas avada ja vaadata .md-faili online?

Klõpsake tööriistaribal failinuppu või lohistage fail redaktorile ja lülitage seejärel vaatele Eelvaade, et lugeda seda vormindatud dokumendina. Kuni 20 MB suurused UTF-8 või UTF-16 kodeeringus failid avanevad otse. Failis olevad pildid kuvatakse, kui neil on täielik veebiaadress; teie arvutis faili kõrval asuvaid pilte ei saa veebileht laadida.

Millist Markdowni varianti redaktor kasutab?

See järgib standardit CommonMark (inglise keeles), milles enamik Markdowni tööriistu on kokku leppinud, ning lisaks GitHubi laiendusi: tabeleid, ülesannete loendeid, läbikriipsutust, automaatseid linke ja allmärkusi. GitHubi, GitLabi, Obsidiani, Redditi või Discordi jaoks kirjutatud tekst näeb siin välja samasugune, välja arvatud funktsioonid, mida need teenused lisavad, näiteks kasutajate mainimised või Obsidiani vikilingid.

Kuidas Markdowni Google Docsi panna?

Klõpsake Kopeeri vormindatud tekstina ja kleepige dokumenti. Pealkirjad, loendid, lingid ja tabelid säilitavad vorminduse. Google Docsi uuemad versioonid oskavad Markdowni ka ise lugeda: kui Markdown on menüü Tööriistad eelistustes lubatud, leiate menüüst Muuda käsu Markdowni kleepimiseks.

Kas redaktor toetab Mermaidi diagramme või LaTeX-i valemeid?

Veel mitte. Mermaidi plokki näidatakse tavalise koodiplokina ja kujul $...$ kirjutatud valemid jäävad lihttekstiks. Kõike muud GitHub Flavored Markdownist toetatakse.

Mis on Markdown ja kes seda kasutab?

Markdown on viis vormindada lihtteksti mõne sümboliga. Selle lõi John Gruber 2004. aastal, et dokument oleks loetav ka enne HTML-iks teisendamist (rohkem Vikipeedias). Arendajad kasutavad seda README-failide ja dokumentatsiooni jaoks, kirjutajad märkmete ja mustandite jaoks ning tehisintellekti vestlusrobotid vastavad selles, mistõttu on nende vastused mujale kleepides täis tärne ja trelle.

Rohkem tekstitööriistu leiate kategooriast Tekst: võrrelge dokumendi kahte versiooni, et näha, mis muutus, või muutke pealkirjade tähesuurust ühe korraga. Arendajad leiavad JSON formatteri ja muud tööriistad kategooriast Arendajad.