Markdown редактор

Този Markdown редактор онлайн показва текста ви отляво и форматирания резултат отдясно, а прегледът се променя с всеки натиснат клавиш. Той разбира Markdown, който се използва в GitHub, в README файлове, уикита и приложения за бележки като Obsidian: заглавия, списъци, списъци със задачи, таблици, код, цитати, връзки, изображения и бележки под линия. Не ви трябва профил и нищо от това, което въвеждате, не се изпраща никъде.

Как да използвате Markdown редактора онлайн

1. Въведете или поставете Markdown в лявото поле или отворете файл .md с бутона за файл в лентата с инструменти. Можете също да пуснете файл където и да е върху редактора.
2. Следете прегледа отдясно. Синхронно превъртане държи двете страни на една и съща част от документа, докато превъртате която и да е от тях.
3. Форматирайте текста с лентата с инструменти или с клавишни комбинации, например Ctrl+B за получер шрифт и Ctrl+K за връзка.
4. Копирайте резултата като Markdown, като HTML или като форматиран текст, или го изтеглете като файл .md, .pdf, .docx, .html или .txt.

Редакторът се отваря с кратък пример, наречен „Бележки по проекта“, който използва всички често срещани елементи, така че да видите синтаксиса и резултата му един до друг, преди да напишете свой текст.

Markdown редактор с преглед на живо

Над редактора има три изгледа. Един до друг показва Markdown и прегледа в две съседни колони, Писане дава цялата ширина на текста, а Преглед показва само резултата и служи като прост инструмент за преглед на Markdown (Markdown viewer) за файл, който някой ви е изпратил. На телефон редакторът превключва между Писане и Преглед, защото две колони биха били твърде тесни за четене.

Прегледът се изобразява така, както GitHub изобразява Markdown: CommonMark с разширенията GitHub Flavored Markdown (и двете на английски), които добавят таблици, списъци със задачи, зачертаване и автоматични връзки. Заглавията получават котви като в GitHub, така че към ## План за издаване може да се води връзка #план-за-издаване, а щракването върху такава връзка превърта прегледа до заглавието. Бележките под линия, записани като [^1], се номерират по реда, в който ги споменавате за първи път, и се изброяват в края.

Текстовото поле използва проверката на правописа в браузъра ви, така че грешно написаните думи се подчертават, докато пишете. Под редактора виждате броя на думите и символите и времето за четене. При броенето синтаксисът на Markdown не се взема предвид, така че при заглавие, отбелязано с ##, се броят само думите му. За да преброите и изреченията, и абзаците, поставете текста в брояча на символи и думи.

Лента с инструменти и клавишни комбинации

Лентата с инструменти съдържа всичко необходимо за обикновен документ: Заглавие, Получер, Курсив, Зачертаване, Код в реда, Връзка, Изображение, Цитат, Блок с код, Списък с водещи символи, Номериран списък, Списък със задачи, Таблица и Хоризонтална линия. Ако първо маркирате текст, бутонът го огражда със съответните знаци; натиснете същия бутон отново и знаците изчезват. Без маркиран текст бутонът вмъква кратък заместващ текст, който вече е маркиран, така че просто пишете върху него.

Няколко подробности пестят време:

• Заглавие превключва текущия ред през #, ##, ### и обратно към обикновен текст.
• Връзка превръща маркираните думи в [думи](https://) и маркира частта с адреса, за да поставите направо URL адреса. Ако вместо това маркирате URL адрес, той става адресът на връзката.
• Бутоните за списъци и Цитат действат върху всички маркирани редове наведнъж. Щракване върху Номериран списък при списък с водещи символи го превръща в номериран.
• Натиснете Enter в края на елемент от списък и следващият елемент започва с правилния знак. Числата нарастват, новата задача започва без отметка, а Enter върху празен елемент завършва списъка. Tab и Shift+Tab увеличават и намаляват отстъпа на елементите от списъка.
• Всяка промяна, направена с бутон или клавишна комбинация, може да се отмени с Ctrl+Z.

Всички клавишни комбинации са изброени в раздела Клавишни комбинации под редактора. На Mac те използват клавиша Command (⌘).

Поставяне от Word или Google Docs като Markdown

Когато поставите текст, копиран от Word, Google Docs или уеб страница, редакторът превръща форматирането му в Markdown, вместо да го изхвърли. Заглавията стават редове с #, получерният текст и курсивът получават своите звездички, връзките запазват адресите си, списъците с водещи символи и номерираните списъци (включително многостепенните списъци на Word) стават списъци в Markdown, а таблиците стават Markdown таблици, в които първият ред е заглавен. Това е най-бързият начин да прехвърлите съществуващ документ в README файл или уики страница.

Ако ви трябва само текстът без форматиране, щракнете върху Поставяне като обикновен текст в съобщението, което се появява след поставянето, или поставете с Ctrl+Shift+V. Код, копиран от VS Code или друг редактор на код, както и текст, който вече е Markdown, се поставят точно както са.

Синтаксис на Markdown: кратък справочник

Най-често използваният синтаксис на един поглед. Въведете лявата колона в редактора, за да видите дясната в прегледа.

Въвеждате	Получавате
# Заглавие, ## Раздел, ### Подраздел	Заглавия от ниво 1 до 3 (до 6 с ######)
**получер** и *курсив*	получер и курсив
~~старо~~	старо
`код`	код с равноширинен шрифт
[текст](https://example.com)	връзка
	изображение
- елемент или 1. елемент	списък с водещи символи или номериран списък
- [ ] задача и - [x] готово	списък със задачи с полета за отметка
> цитиран текст	цитат
три обратни апострофа на отделен ред преди и след кода	блок с код
--- на отделен ред	хоризонтална линия
текст[^1] и [^1]: бележка	бележка под линия

Таблицата в Markdown се нуждае от заглавен ред, разделителен ред от тирета и след това по един ред от текста за всеки ред от таблицата, като клетките се разделят с |. Двоеточие в разделителния ред задава подравняването: :-- подравнява вляво, :-: центрира, а --: подравнява вдясно. Бутонът Таблица вмъква готова таблица с три колони, от която да започнете. Не е нужно клетките да са подравнени в изходния текст, но подравнената таблица се редактира по-лесно по-късно.

Markdown приема и HTML за неща, за които няма собствен синтаксис, например <kbd>Ctrl</kbd> за клавиши, <sub> и <sup> за H₂O и x² или <details> за раздел, който се отваря с щракване. Скриптовете, стиловете и формулярите се премахват от прегледа от съображения за сигурност.

Копиране с форматиране или изтегляне на файла

Копиране на Markdown копира изходния текст, Копиране на HTML копира чист HTML, готов за уебсайт или CMS, а Копиране с форматиране копира форматирания резултат. Поставете го в Google Docs, Word, Outlook или Gmail и заглавията, получерният текст, списъците, връзките и таблиците пристигат форматирани, без да остане нито един символ на Markdown.

Бутоните до Изтегляне записват документа като Markdown, PDF, Word, HTML или обикновен текст с едно щракване, а името на файла се взема от заглавието във front matter или от първото заглавие. Те използват разумни настройки по подразбиране: хартия A4 (Letter в САЩ, Канада, Мексико и другите страни, където този формат е стандартен), нормални полета и текст с размер 11 пункта. За да изберете размера на страницата, шрифтовете и полетата, да добавите съдържание или да конвертирате няколко файла наведнъж, използвайте връзката Още опции за експорт, която отваря Markdown конвертора и прехвърля текста ви в него.

Често задавани въпроси

Качва ли се или записва ли се текстът ми някъде?

Не. Прегледът, конвертирането и изтеглянето се извършват изцяло в браузъра ви и текстът никога не се изпраща до сървър. По подразбиране нищо не се и записва, така че текстът изчезва, когато затворите раздела. Ако отметнете Запазване на черновата в този браузър, текстът се записва в хранилището на собствения ви браузър след всяка промяна и се връща при следващото ви посещение. На споделен компютър махнете отметката, което изтрива и записаната чернова.

Как да отворя и прегледам .md файл онлайн?

Щракнете върху бутона за файл в лентата с инструменти или пуснете файла върху редактора, след което превключете на Преглед, за да го четете като форматиран документ. Файлове до 20 MB в UTF-8 или UTF-16 се отварят директно. Изображенията във файла се показват, когато имат пълен уеб адрес; изображения, записани до файла на компютъра ви, не могат да бъдат заредени от уеб страница.

Кой вариант на Markdown използва редакторът?

Той следва CommonMark (на английски), стандарта, който спазват повечето инструменти за Markdown, плюс разширенията на GitHub: таблици, списъци със задачи, зачертаване, автоматични връзки и бележки под линия. Текст, написан за GitHub, GitLab, Obsidian, Reddit или Discord, изглежда тук по същия начин, с изключение на собствените допълнения на тези услуги, като споменаванията на потребители или уики връзките на Obsidian.

Как да поставя Markdown в Google Docs?

Щракнете върху Копиране с форматиране и поставете в документа. Заглавията, списъците, връзките и таблиците запазват форматирането си. Новите версии на Google Docs могат и сами да четат Markdown: първо включете Markdown в предпочитанията в менюто Инструменти, след което поставянето от Markdown е достъпно в менюто Редактиране.

Поддържа ли редакторът диаграми Mermaid или математически формули LaTeX?

Все още не. Блок Mermaid се показва като обикновен блок с код, а формулите, записани като $...$, остават обикновен текст. Всичко останало от GitHub Flavored Markdown се поддържа.

Какво е Markdown и кой го използва?

Markdown е начин за форматиране на обикновен текст с няколко символа, създаден от Джон Грубер през 2004 г., така че документът да остава четим още преди да бъде преобразуван в HTML (повече в Уикипедия). Разработчиците го използват за README файлове и документация, авторите за бележки и чернови, а чатботовете с изкуствен интелект отговарят с него, затова отговорите им са пълни със звездички и диези, когато ги поставите другаде.

Още инструменти за текст има в категорията Текст: сравнете две версии на документ, за да видите какво се е променило, или променете регистъра на буквите в заглавията наведнъж. Разработчиците ще намерят JSON formatter и други инструменти в категорията Разработчици.