Markdown-szerkesztő

Ez az online Markdown-szerkesztő bal oldalon a szöveget, jobb oldalon a formázott eredményt mutatja, és az előnézet minden billentyűleütéssel frissül. Azt a Markdownt érti, amelyet a GitHubon, a README-fájlokban, a wikikben és az olyan jegyzetalkalmazásokban használnak, mint az Obsidian: címsorokat, listákat, feladatlistákat, táblázatokat, kódot, idézeteket, hivatkozásokat, képeket és lábjegyzeteket. Nincs szükség fiókra, és amit begépel, az nem kerül el sehova.

Az online Markdown-szerkesztő használata

1. Írjon vagy illesszen be Markdownt a bal oldali mezőbe, vagy nyisson meg egy .md fájlt az eszköztár fájlgombjával. A fájlt a szerkesztő bármely pontjára rá is húzhatja.
2. Figyelje az előnézetet a jobb oldalon. Az Együttes görgetés a dokumentum ugyanazon részén tartja a két oldalt, bármelyiket görgeti is.
3. Formázza a szöveget az eszköztárral vagy billentyűparancsokkal: a Ctrl+B például félkövérré teszi a szöveget, a Ctrl+K hivatkozást készít.
4. Másolja ki az eredményt Markdownként, HTML-ként vagy formázott szövegként, vagy töltse le .md, .pdf, .docx, .html vagy .txt fájlként.

A szerkesztő egy rövid, „Projektjegyzetek” című mintával nyílik meg, amely minden gyakori elemet felhasznál, így mielőtt a saját szövegét megírná, egymás mellett láthatja a szintaxist és az eredményét.

Markdown-szerkesztő élő előnézettel

A szerkesztő fölött három nézet közül választhat. Az Egymás mellett nézet a Markdownt és az előnézetet egymás mellé teszi, az Írás a teljes szélességet a szövegnek adja, az Előnézet pedig csak az eredményt mutatja, így egyszerű Markdown-megjelenítőként is használható egy kapott fájlhoz. Telefonon a szerkesztő az Írás és az Előnézet között vált, mert két oszlop túl keskeny lenne az olvasáshoz.

Az előnézet úgy jeleníti meg a Markdownt, ahogy a GitHub: a CommonMark szerint, a GitHub Flavored Markdown bővítményeivel (mindkettő angol nyelven), amelyek táblázatokkal, feladatlistákkal, áthúzással és automatikus hivatkozásokkal egészítik ki. A címsorok a GitHubhoz hasonlóan horgonyt kapnak, így a ## Kiadási terv címsorra #kiadási-terv alakban lehet hivatkozni, és egy ilyen hivatkozásra kattintva az előnézet a címsorhoz gördül. A [^1] formában írt lábjegyzetek az első említésük sorrendjében kapnak számot, és a dokumentum végén jelennek meg.

A szövegmező a böngésző helyesírás-ellenőrzését használja, így az elgépelt szavak már írás közben alá vannak húzva. A szerkesztő alatt látja a szavak és a karakterek számát, valamint az olvasási időt. A számlálás kihagyja a Markdown-szintaxist, így egy ## jellel jelölt címsornál csak a szavai számítanak. Ha a mondatokat és a bekezdéseket is meg szeretné számolni, illessze be a szöveget a szó- és karakterszámlálóba.

Eszköztár és billentyűparancsok

Az eszköztár mindent tartalmaz, ami egy átlagos dokumentumhoz kell: Címsor, Félkövér, Dőlt, Áthúzott, Soron belüli kód, Hivatkozás, Kép, Idézet, Kódblokk, Felsorolásjeles lista, Számozott lista, Feladatlista, Táblázat és Vízszintes vonal. Ha előbb kijelöl egy szöveget, a gomb a jelölők közé foglalja; ha ugyanazt a gombot újra megnyomja, a jelölők eltűnnek. Kijelölés nélkül a gomb egy rövid, már kijelölt helykitöltő szöveget szúr be, így csak át kell írnia.

Néhány részlet, amellyel időt takaríthat meg:

• A Címsor minden kattintással a következő szintre lépteti az aktuális sort: #, ##, ###, majd vissza egyszerű szövegre.
• A Hivatkozás a kijelölt szavakból [szavak](https://) alakot készít, és kijelöli a címrészt, hogy rögtön beilleszthesse az URL-t. Ha ehelyett egy URL-t jelöl ki, az lesz a cím.
• A listagombok és az Idézet egyszerre az összes kijelölt soron működnek. Ha egy felsorolásjeles listán a Számozott lista gombra kattint, a lista számozottá alakul.
• Ha egy listaelem végén Entert nyom, a következő elem a megfelelő jelölővel kezdődik. A számok növekednek, az új feladat üres jelölőnégyzettel indul, üres elemen pedig az Enter lezárja a listát. A Tab és a Shift+Tab növeli, illetve csökkenti a listaelemek behúzását.
• A gombokkal vagy billentyűparancsokkal végzett minden módosítás visszavonható a Ctrl+Z billentyűkombinációval.

Az összes billentyűparancs megtalálható a szerkesztő alatti Billentyűparancsok részben. Macen a Ctrl helyett a Command billentyűt kell használni.

Beillesztés Wordből vagy Google Docsból, Markdownná alakítva

Ha Wordből, Google Docsból (Google Dokumentumok) vagy egy weboldalról másolt szöveget illeszt be, a szerkesztő Markdownná alakítja a formázást ahelyett, hogy eldobná. A címsorokból # jellel kezdődő sorok lesznek, a félkövér és a dőlt szöveg megkapja a csillagait, a hivatkozások megtartják a címüket, a felsorolásjeles és a számozott listák (a Word többszintű listáit is beleértve) Markdown-listákká, a táblázatok pedig Markdown-táblázatokká válnak, amelyekben az első sor lesz a fejléc. Így lehet a leggyorsabban egy meglévő dokumentumot README-fájlba vagy wikioldalra átvinni.

Ha csak a puszta szövegre van szüksége, kattintson a beillesztés után megjelenő üzenetben az Inkább egyszerű szövegként gombra, vagy illesszen be a Ctrl+Shift+V billentyűkombinációval. A VS Code-ból vagy más kódszerkesztőből másolt kódot, valamint a már eleve Markdown formátumú szöveget a szerkesztő pontosan úgy illeszti be, ahogy van.

Markdown-szintaxis: gyors összefoglaló

A leggyakoribb szintaxis egy pillantásra. Írja be a bal oldali oszlop tartalmát a szerkesztőbe, és az előnézetben a jobb oldali oszlopot látja.

Ezt írja be	Ezt kapja
# Cím, ## Szakasz, ### Alszakasz	címsorok az 1. szinttől a 3. szintig (###### jelekkel egészen a 6. szintig)
**félkövér** és *dőlt*	félkövér és dőlt
~~régi~~	régi
`kód`	kód rögzített szélességű betűtípussal
[szöveg](https://example.com)	hivatkozás
	kép
- elem vagy 1. elem	felsorolásjeles vagy számozott lista
- [ ] feladat és - [x] kész	feladatlista jelölőnégyzetekkel
> idézett szöveg	idézet
három fordított aposztróf egy külön sorban a kód előtt és után	kódblokk
--- egy külön sorban	vízszintes vonal
szöveg[^1] és [^1]: megjegyzés	lábjegyzet

A Markdown-táblázathoz kell egy fejlécsor, egy kötőjelekből álló elválasztó sor, majd a táblázat minden sorához egy szövegsor, amelyben a cellákat | jel választja el. Az elválasztó sorban a kettőspont adja meg az igazítást: a :-- balra, a :-: középre, a --: jobbra igazít. A Táblázat gomb egy kész, háromoszlopos táblázatot szúr be kiindulásnak. A celláknak a forrásban nem kell egymás alá kerülniük, de ha egy vonalba rendezi őket, később könnyebb szerkeszteni a táblázatot.

A Markdown HTML-t is elfogad olyan elemekhez, amelyekhez nincs saját szintaxisa, például <kbd>Ctrl</kbd> a billentyűkhöz, <sub> és <sup> a H₂O-hoz és az x²-hez, vagy <details> egy kattintásra kinyíló szakaszhoz. A szerkesztő biztonsági okokból eltávolítja az előnézetből a szkripteket, a stílusokat és az űrlapokat.

Másolás formázott szövegként vagy letöltés fájlként

A Markdown másolása a forrást másolja, a HTML másolása weboldalhoz vagy CMS-hez kész, tiszta HTML-t, a Másolás formázott szövegként pedig a formázott eredményt. Ha ezt beilleszti a Google Docsba, a Wordbe, az Outlookba vagy a Gmailbe, a címsorok, a félkövér szöveg, a listák, a hivatkozások és a táblázatok formázva érkeznek meg, Markdown-jelek nélkül.

A Letöltés gombok egy kattintással mentik a dokumentumot Markdown, PDF, Word, HTML vagy egyszerű szöveg formátumban, a front matterben megadott cím vagy az első címsor alapján elnevezve. Észszerű alapbeállításokat használnak: A4-es papír (Letter az Egyesült Államokban, Kanadában, Mexikóban és más országokban, ahol az a szabvány), normál margók és 11 pontos betűméret. A papírméret, a betűtípusok és a margók kiválasztásához, tartalomjegyzék hozzáadásához vagy több fájl egyidejű átalakításához használja a További exportálási lehetőségek hivatkozást, amely a Markdown-konvertert nyitja meg a már kitöltött szöveggel.

Gyakran ismételt kérdések

Feltöltődik vagy tárolódik valahol a szövegem?

Nem. Az előnézet, az átalakítás és a letöltés is a böngészőjében történik, a szöveg soha nem kerül szerverre. Alapértelmezés szerint semmi sem tárolódik, így a szöveg eltűnik, amikor bezárja a lapot. Ha bejelöli a Piszkozat megőrzése ebben a böngészőben beállítást, a szöveg minden módosítás után a böngészője saját tárhelyére kerül, és a következő látogatáskor visszatér. Közös számítógépen vegye ki a jelölést, ezzel a mentett piszkozat is törlődik.

Hogyan lehet egy .md fájlt online megnyitni és megtekinteni?

Kattintson az eszköztár fájlgombjára, vagy húzza a fájlt a szerkesztőre, majd váltson az Előnézet nézetre, hogy formázott dokumentumként olvassa. A legfeljebb 20 MB-os, UTF-8 vagy UTF-16 kódolású fájlok közvetlenül megnyílnak. A fájlban lévő képek akkor jelennek meg, ha teljes webcímük van; a számítógépén a fájl mellett tárolt képeket egy weboldal nem tudja betölteni.

Melyik Markdown-változatot használja a szerkesztő?

A CommonMark (angol nyelven) szabványt követi, amelyet a legtöbb Markdown-eszköz elfogad, kiegészítve a GitHub bővítményeivel: táblázatok, feladatlisták, áthúzás, automatikus hivatkozások és lábjegyzetek. A GitHubra, GitLabra, Obsidianba, Redditre vagy Discordra írt szöveg itt is ugyanúgy néz ki, kivéve azokat a funkciókat, amelyeket ezek a szolgáltatások maguk tesznek hozzá, például a felhasználók megemlítését vagy az Obsidian wikihivatkozásait.

Hogyan lehet Markdownt bemásolni a Google Docsba?

Kattintson a Másolás formázott szövegként gombra, és illessze be a szöveget a dokumentumba. A címsorok, a listák, a hivatkozások és a táblázatok megtartják a formázásukat. A Google Docs újabb verziói maguk is be tudják olvasni a Markdownt: a Szerkesztés menüben van egy parancs a Markdownból való beillesztésre, miután a Markdownt bekapcsolta az Eszközök menü Beállítások ablakában.

Támogatja a szerkesztő a Mermaid-diagramokat vagy a LaTeX-képleteket?

Egyelőre nem. A Mermaid-blokk közönséges kódblokként jelenik meg, a $...$ formában írt képletek pedig egyszerű szövegként maradnak. A GitHub Flavored Markdown minden más eleme támogatott.

Mi az a Markdown, és kik használják?

A Markdown olyan jelölésmód, amellyel az egyszerű szöveg néhány jellel formázható. John Gruber alkotta meg 2004-ben, hogy a dokumentum már a HTML-re alakítás előtt is olvasható legyen (bővebben a Wikipédián). A fejlesztők README-fájlokhoz és dokumentációhoz használják, az írók jegyzetekhez és vázlatokhoz, és az MI-alapú csevegőprogramok is ebben válaszolnak, ezért van tele a válaszuk csillagokkal és kettőskeresztekkel, ha máshová illesztik be őket.

További szövegkezelő eszközöket a Szöveg kategóriában talál: összehasonlíthatja egy dokumentum két változatát, hogy lássa, mi változott, vagy egy lépésben átalakíthatja a címsorok kis- és nagybetűit. A fejlesztők a JSON-formázót és további eszközöket a Fejlesztők kategóriában találják.