Editor Markdown

Ky editor Markdown online e shfaq tekstin tuaj majtas dhe rezultatin e formatuar djathtas, dhe pamja paraprake ndryshon me çdo tast që shtypni. Ai e kupton Markdown-in që përdoret në GitHub, në skedarët README, në wiki dhe në aplikacionet e shënimeve si Obsidian: tituj, lista, lista detyrash, tabela, kod, citime, lidhje, imazhe dhe fusnota. Nuk ju duhet llogari dhe asgjë që shkruani nuk dërgohet askund.

Si përdoret editori Markdown online

1. Shkruani ose ngjitni Markdown në fushën e majtë, ose hapni një skedar .md me butonin e skedarit në shiritin e veglave. Mund ta lëshoni skedarin edhe kudo mbi editor.
2. Ndiqni pamjen paraprake djathtas. Lëviz të dyja anët bashkë i mban të dyja anët në të njëjtën pjesë të dokumentit, cilëndo prej tyre të lëvizni.
3. Formatoni tekstin me shiritin e veglave ose me shkurtore si Ctrl+B për tekst të trashë dhe Ctrl+K për një lidhje.
4. Kopjoni rezultatin si Markdown, si HTML ose si tekst të formatuar, ose shkarkojeni si skedar .md, .pdf, .docx, .html ose .txt.

Editori hapet me një shembull të shkurtër me titullin „Shënime projekti“, që përdor të gjitha elementet e zakonshme, kështu që e shihni sintaksën dhe rezultatin e saj pranë njëri-tjetrit para se të shkruani tekstin tuaj.

Editor Markdown me pamje paraprake në kohë reale

Mbi editor ka tri pamje. Krah për krah vendos Markdown-in dhe pamjen paraprake pranë njëri-tjetrit, Shkruaj ia jep tekstit gjithë gjerësinë dhe Parapamje shfaq vetëm rezultatin, kështu që funksionon si një shikues i thjeshtë Markdown (Markdown viewer) për një skedar që jua ka dërguar dikush. Në celular editori kalon ndërmjet Shkruaj dhe Parapamje, sepse dy kolona do të ishin tepër të ngushta për t’u lexuar.

Pamja paraprake shfaqet ashtu siç e shfaq GitHub Markdown-in: CommonMark me zgjerimet e GitHub Flavored Markdown (të dyja në anglisht), që shtojnë tabela, lista detyrash, tekst të vizuar në mes dhe lidhje automatike. Titujt marrin ankora si në GitHub, kështu që ## Plani i publikimit mund të lidhet si #plani-i-publikimit, dhe klikimi i një lidhjeje të tillë e lëviz pamjen paraprake te titulli. Fusnotat e shkruara si [^1] numërohen sipas radhës në të cilën i përmendni për herë të parë dhe renditen në fund.

Fusha e tekstit përdor kontrollin drejtshkrimor të shfletuesit tuaj, kështu që fjalët e shkruara gabim nënvizohen ndërsa shkruani. Nën editor shihni numrin e fjalëve dhe të shenjave, si dhe kohën e leximit. Numërimi e lë jashtë sintaksën Markdown, kështu që një titull i shënuar me ## numëron vetëm fjalët e veta. Për të numëruar edhe fjalitë dhe paragrafët, ngjitni tekstin te numëruesi i fjalëve dhe shenjave.

Shiriti i veglave dhe shkurtoret e tastierës

Shiriti i veglave mbulon gjithçka që ju nevojitet për një dokument të zakonshëm: Titull, Të trasha, Të pjerrëta, Të vizuara në mes, Kod në rresht, Lidhje, Imazh, Citim, Bllok kodi, Listë me pika, Listë me numra, Listë detyrash, Tabelë dhe Vijë horizontale. Përzgjidhni fillimisht pak tekst dhe butoni e mbështjell; shtypni sërish të njëjtin buton dhe shenjat zhduken. Pa përzgjedhje, butoni fut një tekst të shkurtër zëvendësues që është tashmë i përzgjedhur, kështu që thjesht shkruani mbi të.

Disa detaje kursejnë kohë:

• Titull e kalon rreshtin aktual nëpër #, ##, ### dhe pastaj përsëri në tekst të thjeshtë.
• Lidhje i shndërron fjalët e përzgjedhura në [fjalët](https://) dhe përzgjedh pjesën e adresës, gati që të ngjitni URL-në. Nëse përzgjidhni një URL, ajo bëhet adresa.
• Butonat e listave dhe Citim punojnë njëherësh në të gjithë rreshtat e përzgjedhur. Klikimi i Listë me numra mbi një listë me pika e shndërron atë në listë me numra.
• Shtypni Enter në fund të një elementi liste dhe elementi tjetër fillon me shenjën e duhur. Numrat rriten, një detyrë e re fillon e pashënuar, dhe Enter në një element bosh e përfundon listën. Tab dhe Shift+Tab e rrisin dhe e zvogëlojnë dhëmbëzimin e elementeve të listës.
• Çdo ndryshim i bërë me një buton ose me një shkurtore mund të zhbëhet me Ctrl+Z.

Të gjitha shkurtoret renditen te Shkurtoret e tastierës nën editor. Në Mac ato përdorin tastin Command (⌘).

Ngjitni nga Word ose Google Docs dhe merrni Markdown

Kur ngjitni tekst të kopjuar nga Word, Google Docs ose një faqe interneti, editori e shndërron formatimin e tij në Markdown në vend që ta hedhë poshtë. Titujt bëhen rreshta me #, teksti i trashë dhe i pjerrët merr yjet e vet, lidhjet i ruajnë adresat, listat me pika dhe me numra (përfshirë listat shumënivelëshe të Word-it) bëhen lista Markdown, dhe tabelat bëhen tabela Markdown me rreshtin e parë si kokë. Kjo është mënyra më e shpejtë për ta kaluar një dokument ekzistues në një README ose në një faqe wiki.

Nëse donit vetëm tekstin e zhveshur, klikoni Përdor tekst të thjeshtë në vend të kësaj te njoftimi që shfaqet pas ngjitjes, ose ngjitni me Ctrl+Shift+V. Kodi i kopjuar nga VS Code ose nga një editor tjetër kodi, si dhe teksti që është tashmë Markdown, ngjitet saktësisht siç është.

Përmbledhje e sintaksës Markdown

Sintaksa më e zakonshme me një shikim. Shkruani kolonën e majtë në editor për të parë kolonën e djathtë në pamjen paraprake.

Shkruani	Merrni
# Titull, ## Seksion, ### Nënseksion	Tituj nga niveli 1 deri në nivelin 3 (deri në 6 me ######)
**të trasha** dhe *të pjerrëta*	të trasha dhe të pjerrëta
~~e vjetër~~	e vjetër
`kod`	kod me font me gjerësi fikse
[tekst](https://example.com)	një lidhje
	një imazh
- element ose 1. element	një listë me pika ose me numra
- [ ] detyrë dhe - [x] e kryer	një listë detyrash me kutiza
> tekst i cituar	një citim
tri shenja backtick në një rresht para dhe pas kodit	një bllok kodi
--- në një rresht më vete	një vijë horizontale
tekst[^1] dhe [^1]: shënim	një fusnotë

Një tabelë Markdown ka nevojë për një rresht kokë, një rresht ndarës me viza dhe pastaj një rresht për çdo rresht të tabelës, me qelizat e ndara me |. Dy pikat në rreshtin ndarës caktojnë rreshtimin: :-- e rreshton majtas, :-: në qendër dhe --: djathtas. Butoni Tabelë fut një tabelë të gatshme me tri kolona për të filluar. Qelizat nuk kanë nevojë të jenë të radhitura njëra nën tjetrën në burim, por kur janë të radhitura, tabela redaktohet më lehtë më vonë.

Markdown pranon edhe HTML për gjërat për të cilat nuk ka sintaksë, si <kbd>Ctrl</kbd> për tastet, <sub> dhe <sup> për H₂O dhe x², ose <details> për një seksion që hapet me klikim. Skriptet, stilet dhe formularët hiqen nga pamja paraprake për siguri.

Kopjoni si tekst të formatuar ose shkarkoni skedarin

Kopjo Markdown kopjon burimin, Kopjo HTML kopjon HTML të pastër, gati për një faqe interneti ose një CMS, dhe Kopjo si tekst të formatuar kopjon rezultatin e formatuar. Ngjiteni në Google Docs, Word, Outlook ose Gmail dhe titujt, teksti i trashë, listat, lidhjet dhe tabelat vijnë të formatuara, pa asnjë simbol Markdown.

Butonat Shkarko e ruajnë dokumentin si Markdown, PDF, Word, HTML ose tekst të thjeshtë me një klikim, me emrin e titullit në front matter ose të titullit të parë. Ata përdorin cilësime të arsyeshme të parazgjedhura: letër A4 (Letter në SHBA, Kanada, Meksikë dhe vende të tjera ku ky është standardi), margjina normale dhe tekst 11 pikë. Për të zgjedhur madhësinë e faqes, fontet dhe margjinat, për të shtuar një tabelë të përmbajtjes ose për të konvertuar disa skedarë njëherësh, përdorni Më shumë opsione eksporti, që hap konvertuesin Markdown me tekstin tuaj tashmë të plotësuar.

Pyetje të shpeshta

A ngarkohet apo ruhet diku teksti im?

Jo. Pamja paraprake, konvertimi dhe shkarkimet kryhen të gjitha në shfletuesin tuaj, dhe teksti nuk dërgohet kurrë në një server. Si parazgjedhje nuk ruhet as asgjë, kështu që teksti zhduket kur mbyllni skedën. Nëse shënoni Ruaje draftin në këtë shfletues, teksti ruhet në hapësirën ruajtëse të shfletuesit tuaj pas çdo ndryshimi dhe rikthehet në vizitën tuaj të radhës. Në një kompjuter të përbashkët hiqeni shenjën, gjë që fshin edhe draftin e ruajtur.

Si të hap dhe të shikoj online një skedar .md?

Klikoni butonin e skedarit në shiritin e veglave ose lëshojeni skedarin mbi editor, pastaj kaloni te Parapamje për ta lexuar si dokument të formatuar. Skedarët deri në 20 MB në UTF-8 ose UTF-16 hapen drejtpërdrejt. Imazhet në skedar shfaqen kur kanë një adresë të plotë interneti; imazhet e ruajtura pranë skedarit në kompjuterin tuaj nuk mund të ngarkohen nga një faqe interneti.

Cilin variant të Markdown përdor editori?

Ndjek CommonMark (në anglisht), standardin për të cilin bien dakord shumica e mjeteve Markdown, plus zgjerimet e GitHub: tabela, lista detyrash, tekst të vizuar në mes, lidhje automatike dhe fusnota. Teksti i shkruar për GitHub, GitLab, Obsidian, Reddit ose Discord duket njësoj edhe këtu, përveç veçorive që këto shërbime shtojnë vetë, si përmendjet e përdoruesve ose lidhjet wiki të Obsidian.

Si ta fus Markdown-in në Google Docs?

Klikoni Kopjo si tekst të formatuar dhe ngjiteni në dokument. Titujt, listat, lidhjet dhe tabelat e ruajnë formatimin. Versionet e reja të Google Docs mund ta lexojnë edhe vetë Markdown-in me komandën për ngjitje nga Markdown te menyja e redaktimit, pasi ta keni aktivizuar Markdown-in te preferencat e Google Docs.

A i mbështet editori diagramet Mermaid ose formulat matematikore LaTeX?

Ende jo. Një bllok Mermaid shfaqet si bllok i zakonshëm kodi, dhe formulat e shkruara si $...$ mbeten tekst i thjeshtë. Gjithçka tjetër nga GitHub Flavored Markdown mbështetet.

Çfarë është Markdown dhe kush e përdor?

Markdown është një mënyrë për të formatuar tekst të thjeshtë me pak simbole, e krijuar nga John Gruber në vitin 2004 që një dokument të mbetet i lexueshëm edhe para se të shndërrohet në HTML (më shumë në Wikipedia, në anglisht). Zhvilluesit e përdorin për skedarët README dhe për dokumentacionin, shkrimtarët për shënime dhe drafte, dhe mjetet e bisedës me AI përgjigjen me të, prandaj përgjigjet e tyre janë plot me yje dhe shenja # kur ngjiten diku tjetër.

Më shumë mjete për tekstin gjeni në kategorinë Teksti: krahasoni dy versione të një dokumenti për të parë çfarë ka ndryshuar, ose ndryshoni shkronjat e mëdha dhe të vogla të titujve njëherësh. Zhvilluesit do të gjejnë JSON formatter-in dhe mjete të tjera te Zhvilluesit.