Markdown redaktors

Šis Markdown redaktors tiešsaistē rāda jūsu tekstu kreisajā pusē un formatēto rezultātu labajā pusē, un priekšskatījums mainās ar katru nospiesto taustiņu. Tas saprot Markdown, ko lieto platformā GitHub, README failos, wiki vietnēs un piezīmju lietotnēs, piemēram, Obsidian: virsrakstus, sarakstus, uzdevumu sarakstus, tabulas, kodu, citātus, saites, attēlus un zemsvītras piezīmes. Konts nav vajadzīgs, un nekas no ierakstītā netiek nekur sūtīts.

Kā lietot Markdown redaktoru tiešsaistē

1. Ierakstiet vai ielīmējiet Markdown kreisajā laukā vai atveriet .md failu ar faila pogu rīkjoslā. Failu var arī ievilkt jebkurā redaktora vietā.
2. Sekojiet priekšskatījumam labajā pusē. Opcija Ritināt abas puses kopā tur abas puses pie vienas un tās pašas dokumenta daļas, lai kuru no tām jūs ritinātu.
3. Formatējiet tekstu ar rīkjoslu vai īsinājumtaustiņiem, piemēram, Ctrl+B treknrakstam un Ctrl+K saitei.
4. Kopējiet rezultātu kā Markdown, HTML vai formatētu tekstu vai lejupielādējiet to kā .md, .pdf, .docx, .html vai .txt failu.

Redaktors atveras ar īsu paraugu „Projekta piezīmes”, kurā izmantoti visi biežākie elementi, tāpēc sintaksi un tās rezultātu varat redzēt blakus, pirms sākat rakstīt paši.

Markdown redaktors ar reāllaika priekšskatījumu

Virs redaktora ir trīs skati. Blakus novieto Markdown un priekšskatījumu vienu otram blakus, Rakstīt atvēl visu platumu tekstam, bet Skatīt rāda tikai rezultātu, tāpēc der kā vienkāršs Markdown skatītājs failam, ko kāds jums atsūtījis. Tālrunī redaktors pārslēdzas starp Rakstīt un Skatīt, jo divas kolonnas būtu par šauru lasīšanai.

Priekšskatījums tiek attēlots tāpat, kā Markdown attēlo GitHub: pēc CommonMark ar GitHub Flavored Markdown paplašinājumiem (abi angļu valodā), kas pievieno tabulas, uzdevumu sarakstus, pārsvītrojumu un automātiskas saites. Virsraksti saņem enkurus tāpat kā GitHub, tāpēc uz ## Laidiena plāns var norādīt saiti #laidiena-plāns, un, noklikšķinot uz šādas saites, priekšskatījums aizritina līdz virsrakstam. Zemsvītras piezīmes, kas rakstītas kā [^1], tiek numurētas secībā, kādā tās pirmo reizi pieminētas, un uzskaitītas beigās.

Teksta laukā darbojas jūsu pārlūka pareizrakstības pārbaude, tāpēc kļūdaini vārdi tiek pasvītroti jau rakstīšanas laikā. Zem redaktora redzams vārdu un rakstzīmju skaits un lasīšanas laiks. Markdown sintakse skaitā netiek iekļauta, tāpēc virsrakstam, kas atzīmēts ar ##, tiek skaitīti tikai tā vārdi. Lai saskaitītu arī teikumus un rindkopas, ielīmējiet tekstu vārdu un rakstzīmju skaitītājā.

Rīkjosla un īsinājumtaustiņi

Rīkjoslā ir viss, kas vajadzīgs tipiskam dokumentam: Virsraksts, Treknraksts, Slīpraksts, Pārsvītrojums, Kods rindā, Saite, Attēls, Citāts, Koda bloks, Aizzīmju saraksts, Numurēts saraksts, Uzdevumu saraksts, Tabula un Horizontāla līnija. Vispirms atlasiet tekstu, un poga to ietvers atzīmēs; nospiediet to pašu pogu vēlreiz, un atzīmes pazudīs. Ja nekas nav atlasīts, poga ievieto īsu viettura tekstu, kas jau ir atlasīts, tāpēc varat vienkārši rakstīt tam pāri.

Daži sīkumi ietaupa laiku:

• Virsraksts pārslēdz pašreizējo rindu pa kārtai uz #, ##, ### un atpakaļ uz parastu tekstu.
• Saite pārvērš atlasītos vārdus par [vārdi](https://) un atlasa adreses daļu, lai varētu uzreiz ielīmēt URL. Ja atlasāt URL, tas kļūst par adresi.
• Sarakstu pogas un Citāts attiecas uz visām atlasītajām rindām vienlaikus. Ja aizzīmju sarakstā noklikšķināt uz Numurēts saraksts, tas kļūst par numurētu sarakstu.
• Nospiediet Enter saraksta vienuma beigās, un nākamais vienums sāksies ar pareizo atzīmi. Numuri pieaug, jauns uzdevums sākas neatzīmēts, bet Enter tukšā vienumā sarakstu beidz. Tab un Shift+Tab palielina un samazina saraksta vienumu atkāpi.
• Katru izmaiņu, kas veikta ar pogu vai īsinājumtaustiņu, var atsaukt ar Ctrl+Z.

Visi īsinājumtaustiņi ir uzskaitīti zem redaktora sadaļā Īsinājumtaustiņi. Mac datorā Ctrl vietā izmanto taustiņu Command.

Ielīmējiet no Word vai Google Docs un iegūstiet Markdown

Kad ielīmējat tekstu, kas nokopēts no Word, Google Docs vai tīmekļa lapas, redaktors tā formatējumu pārvērš par Markdown, nevis izmet. Virsraksti kļūst par # rindām, trekns un slīps teksts saņem zvaigznītes, saites saglabā adreses, aizzīmju un numurētie saraksti (arī Word daudzlīmeņu saraksti) kļūst par Markdown sarakstiem, bet tabulas kļūst par Markdown tabulām, kurās pirmā rinda ir galvene. Tas ir ātrākais veids, kā pārnest esošu dokumentu uz README failu vai wiki lapu.

Ja vēlējāties tikai tekstu, piezīmē, kas parādās pēc ielīmēšanas, noklikšķiniet uz Izmantot vienkāršu tekstu vai ielīmējiet ar Ctrl+Shift+V. Kods, kas nokopēts no VS Code vai cita koda redaktora, un teksts, kas jau ir Markdown, tiek ielīmēts tieši tāds, kāds tas ir.

Markdown sintakses atgādne

Biežāk lietotā sintakse vienuviet. Ierakstiet kreisās kolonnas saturu redaktorā, un priekšskatījumā redzēsiet labās kolonnas rezultātu.

Jūs rakstāt	Jūs iegūstat
# Virsraksts, ## Sadaļa, ### Apakšsadaļa	1. līdz 3. līmeņa virsraksti (līdz 6. līmenim ar ######)
**trekns** un *slīps*	trekns un slīps
~~vecs~~	vecs
`kods`	kods vienplatuma fontā
[teksts](https://example.com)	saite
	attēls
- vienums vai 1. vienums	aizzīmju vai numurēts saraksts
- [ ] uzdevums un - [x] gatavs	uzdevumu saraksts ar izvēles rūtiņām
> citēts teksts	citāts
trīs atpakaļvērsti apostrofi atsevišķā rindā pirms un pēc koda	koda bloks
--- atsevišķā rindā	horizontāla līnija
teksts[^1] un [^1]: piezīme	zemsvītras piezīme

Markdown tabulai vajadzīga galvenes rinda, atdalītājrinda no defisēm un pēc tam pa vienai rindai katrai tabulas rindai, šūnas atdalot ar |. Kols atdalītājrindā nosaka līdzinājumu: :-- līdzina pa kreisi, :-: centrē un --: līdzina pa labi. Poga Tabula ievieto gatavu trīs kolonnu tabulu, no kuras sākt. Avota tekstā šūnām nav jābūt izlīdzinātām, taču izlīdzinātu tabulu vēlāk ir vieglāk rediģēt.

Markdown ļauj izmantot arī HTML tam, kam tajā nav savas sintakses, piemēram, <kbd>Ctrl</kbd> taustiņiem, <sub> un <sup> pierakstam H₂O un x² vai <details> sadaļai, kas atveras ar klikšķi. Drošības nolūkos skripti, stili un veidlapas no priekšskatījuma tiek noņemti.

Kopēšana ar formatējumu vai faila lejupielāde

Kopēt Markdown kopē avota tekstu, Kopēt HTML kopē tīru HTML, kas gatavs tīmekļa vietnei vai CMS, bet Kopēt ar formatējumu kopē formatēto rezultātu. Ielīmējiet to Google Docs, Word, Outlook vai Gmail, un virsraksti, treknraksts, saraksti, saites un tabulas tiks ielīmēti formatēti, bez neviena Markdown simbola.

Pogas pie Lejupielādēt ar vienu klikšķi saglabā dokumentu kā Markdown, PDF, Word, HTML vai vienkāršu tekstu, un faila nosaukums tiek ņemts no dokumenta nosaukuma front matter galvenē vai no pirmā virsraksta. Tās izmanto saprātīgus noklusējuma iestatījumus: A4 papīru (Letter ASV, Kanādā, Meksikā un citās valstīs, kur tas ir standarts), parastas piemales un 11 punktu tekstu. Lai izvēlētos lapas izmēru, fontus un piemales, pievienotu satura rādītāju vai konvertētu vairākus failus vienlaikus, izmantojiet Vairāk eksporta iespēju, kas atver Markdown konvertētāju ar jau ievietotu jūsu tekstu.

Biežāk uzdotie jautājumi

Vai mans teksts tiek kaut kur augšupielādēts vai saglabāts?

Nē. Priekšskatījums, konvertēšana un lejupielādes notiek jūsu pārlūkā, un teksts nekad netiek sūtīts uz serveri. Pēc noklusējuma nekas netiek arī saglabāts, tāpēc, aizverot cilni, teksts pazūd. Ja atzīmējat Saglabāt melnrakstu šajā pārlūkā, teksts pēc katras izmaiņas tiek saglabāts jūsu pārlūka krātuvē un atgriežas nākamajā apmeklējumā. Koplietotā datorā noņemiet atzīmi; tādējādi tiek dzēsts arī saglabātais melnraksts.

Kā atvērt un skatīt .md failu tiešsaistē?

Noklikšķiniet uz faila pogas rīkjoslā vai ievelciet failu redaktorā, tad pārslēdzieties uz Skatīt, lai to lasītu kā formatētu dokumentu. Faili līdz 20 MB UTF-8 vai UTF-16 kodējumā atveras uzreiz. Attēli failā tiek parādīti, ja tiem ir pilna tīmekļa adrese; attēlus, kas glabājas blakus failam jūsu datorā, tīmekļa lapa ielādēt nevar.

Kādu Markdown variantu redaktors izmanto?

Tas ievēro CommonMark (angļu valodā), standartu, par kuru vienojušies vairums Markdown rīku, kā arī GitHub paplašinājumus: tabulas, uzdevumu sarakstus, pārsvītrojumu, automātiskas saites un zemsvītras piezīmes. Teksts, kas rakstīts GitHub, GitLab, Obsidian, Reddit vai Discord vajadzībām, šeit izskatās tāpat, izņemot funkcijas, ko šie pakalpojumi pievieno papildus, piemēram, lietotāju pieminējumus vai Obsidian wiki saites.

Kā ievietot Markdown Google Docs dokumentā?

Noklikšķiniet uz Kopēt ar formatējumu un ielīmējiet dokumentā. Virsraksti, saraksti, saites un tabulas saglabā formatējumu. Jaunākās Google Docs versijas Markdown prot nolasīt arī pašas: kad Markdown atbalsts ir ieslēgts Google Docs preferencēs, rediģēšanas izvēlnē ir pieejama ielīmēšana no Markdown.

Vai redaktors atbalsta Mermaid diagrammas vai LaTeX formulas?

Pagaidām nē. Mermaid bloks tiek parādīts kā parasts koda bloks, un formulas, kas rakstītas kā $...$, paliek kā parasts teksts. Viss pārējais no GitHub Flavored Markdown tiek atbalstīts.

Kas ir Markdown un kas to izmanto?

Markdown ir veids, kā formatēt vienkāršu tekstu ar dažiem simboliem. To 2004. gadā izveidoja Džons Grūbers (John Gruber), lai dokuments būtu labi lasāms vēl pirms pārvēršanas HTML formātā (vairāk Vikipēdijā, angļu valodā). Izstrādātāji to izmanto README failiem un dokumentācijai, rakstītāji piezīmēm un melnrakstiem, un MI tērzēšanas rīki atbild tieši Markdown formātā, tāpēc to atbildes, ielīmētas citur, ir pilnas ar zvaigznītēm un restītēm.

Vairāk teksta rīku ir kategorijā Teksts: salīdziniet divas dokumenta versijas, lai redzētu, kas mainījies, vai mainiet burtu reģistru visiem virsrakstiem uzreiz. Izstrādātāji kategorijā Izstrādātāji atradīs JSON formatētāju un citus rīkus.