Какво е Markdown (маркдаун)?¶
Markdown (произнася се маркдаун) е средство за конвертиране на обикновен текст в HTML-формат. Той е създаден да е лесен за четене и писане, и удобен за преобразуване в структурно валиден XHTML/HTML-формат. Основната цел на създателя му е да направи удобен формат за писане в Интернет. Маркдаун не е заместител на HTML, а опростен синтаксис за четене, писане и редактиране на уеб съдържание.
Тоест маркдаун представлява две неща:
- синтаксис за форматиране на обикновен текст с не-азбучни знаци като
#
,*
,_
,>
,|
, и др.; - софтуерен инструмент, написан на програмния език Perl, който конвертира обикновен текст в HTML-формат.
Синтаксисът на маркдаун е много достъпен и лесен за бързо усвояване, и затова днес той се радва на широко разпространение и употреба (напр. на сайтове като Github), включително документацията, която четете в момента.
Информацията се записва като обикновен текстов файл с разширение .md
или .markdown
1.
Примерен Markdown файл¶
# Заглавие
## Подзаглавие
### По-малко заглавие
#### И така нататък
Всеки параграф, заглавие или друго е разделено с празен ред в края.
Ако го няма празен ред, се долепят. Текстът може да е *италик*, **удебелен** или `отбелязан`.
Списъци по-долу, а връзки като този [линк към OpenStreetMap](https://osm.org).
- списъци
- разни
1. подредени
2. списъци
И таблици:
| Име | Град |
|-----|------|
| Иван | Русе |
| Цвета | Кърджали |
\```
print('Hello, qgis')
\```

Работа с Markdown¶
За да започнете да работите с маркдаун Ви е необходим текстов редактор. В него към обикновения текст се прибавят форматиращите елементи на маркдаун синтаксиса.
Препоръчан и безплатен текстови редактор с поддръжка на Markdown е Visual Studio Code.
Работа с Markdown във Visual Studio Code¶
- Отворете Markdown файл, например
TODO/0000_kakvo_e_markdown.md
. - Инсталирайте плъгина
Markdown All in One
(незадължително). - Изпълнете командата
Markdown: Open Preview to the Side
. Сега вече виждате съдържанието на файла в почти по същия начин, както в тази документация.
-
(bg) Първи стъпки с маркдаун ↩