Markdown е може би най-добрият начин да си водите бележки на компютър. Обясняваме как да го използвате

За да си водите бележки на компютър, много от нас знаят типичния: Word или LibreOffice Writer. Това е добър вариант за някои сценарии, но ако това, което искаме, е да си водим бележки, да го правим бързо, да ги имаме в определен формат и да ги отваряме с не много тежък зрител, вероятно е най-добре да използваме това, което е известно като Markdown. Тук ще обясним какво е това, как се "маркира" текстът и ще посочим някои редактори/изгледи, които си заслужават в Linux.

Markdown е a лека маркировка, чиято цел е да увеличи максимално четливостта и лекотата на публикуване, както във входната, така и в изходната форма. Подобно на HTML, Markdown показва текст по различни начини в зависимост от маркирането, което използваме върху него, като удебелен шрифт и курсив. Създаден е от Джон Грубер и покойния Арън Суорц и без да навлизаме много в историята му, ще обясним как да го използваме.

Как да създадете Markdown документи

Създаването на Markdown документ е нещо, което можем да го направим с всеки редактор на обикновен текст. Това е същото в HTML, но Markdown е по-лесен за писане. HTML използва входни и изходни тагове и във всички случаи те имат по-малко от () символи, което не е най-удобното за писане, поне на испанска клавиатура. Много от знаците, които ще използваме в Markdown, също трябва да бъдат поставени преди и след всяка дума, но използването на две звездички не е същото като символите, които HTML използва. Единственото нещо, от което се нуждаете, в допълнение към маркировките, е да запазите файла с разширение .md или .markdown.

Markdown Той няма толкова опции, колкото HTML, но и той не го възнамерява. Има някои, които можем да намерим в интернет, които може да не се поддържат от програма за преглед на документи, съвместима с Markdown, но най-използваните са и те са следните:

Пространства в Markdown

Не бих искал да започвам или завършвам статията без този раздел. И в някои марки, като тези за заглавки или списъци, трябва да поставите интервал между символа и текста. Може да получим очаквания резултат без тези интервали, но това подобрява четливостта и се счита за добра практика.

Заглавни заглавия

В HTML те са известни като h1-h6. Семантично те трябва да се използват като компоненти на индекс; Не е нужно да ги използвате, за да поставите по-голям или по-малък текст. На теория h1 трябва да бъде само заглавие на страница, h2 са част от h1, h3 са част от h2 и т.н. Например, „Как да създадете Markdown документи“ в тази статия е h2, който е в рамките на общата статия с h1, и „Header Headlines“ и това, което ще последва, ще бъде h3, които са част от раздела как са създадени.

В HTML тагът би бил TEXT, докато в Markdown е с два решетка отпред:

## Това ще бъде h2

Броят на подложките показва номера на заглавката, като максимумът е 6.

Удебелен, курсив, зачертано и подчертано

Текстове с удебелен шрифт (b o силен в HTML) и курсив (i o em в HTML) изглеждат много сходни, толкова много, че може да бъде объркващо. може да се постави удебелен текст, заобикалящ го с две долни черти, и в курсив с долна черта от всяка страна. Следователно три долни черти биха направили текста удебелен и курсив. И точно същото със звездичките.

За да избегнете объркване, бих препоръчал да използвате долна черта за курсив и две звездички за получер:

удебелен шрифт
 _курсив_

Може да не се поддържа в някои визуализатори, но можете да задраскате текст, като поставите мустака Ñ отпред и отзад два пъти (~~) и го маркирате като с маркер с два еднакви символа отпред и отзад (==) .

~~Зачеркнато~~
==Откроено==

Не виждам маркираното във VSCode или някои програми за преглед на Linux, но го виждам в бележките на браузъра Vivaldi.

Ако се чудите как да подчертаете, това не съществува в Markdown, колкото и да е странно. Ако трябва да подчертаете текст, най-добре е да използвате HTML тага подчертан текст.

Степен и индекс

Ако искаме да поставим a номер, повишен до друг, което е степента, може да се направи, като поставите първото число, последвано от циркумфлекса (^) и след това степента: 2^4 ще покаже 2⁴. Има начини да поставите числото от противоположната страна (долен индекс), но подобно на текста на маркера, не се поддържа от всички процесори. Постига се с мустак на Ñ от всяка страна на текста или цифрата: h~2~или изглежда h₂или (ако не се вижда, представете си, че 2 е по-ниско).

Параграфи

обикновено няма нужда да използвате маркиране за параграфи, но трябва да знаете няколко неща. Те имат това, което е известно като трудно прекъсване и в началото не можете да поставите текст като следния, който би се видял в стихотворение:

Един ден през януари (интервал) (интервал)
Изглежда добър ден (интервал) (интервал)
Страхотна поезия (пространство)
Блогърът написа (интервал)(интервал)

В предишния текст Markdown поставя всичко подред, но номерът е да поставите два интервала в края на всеки ред. По този начин той зачита това, което търсим. Като алтернатива можете да добавите обратна наклонена черта и е препоръчително, ако искате да поставите блокове от редове с еднакъв формат (удебелен, курсив...) само с два символа в началото и два в края на целия блок.

Списъци

В HTML има поне три типа списъци, подредени (с числа отпред), неподредени (точки отпред) и дефиниции, ol, ul y dl съответно в HTML. В Markdown имаме същото нещо и те ще бъдат създадени така:

Неподредени списъци

С тире отпред:

- Първи елемент
- Втори елемент
- Трети елемент

и също със звездичка:

*Това ще бъде първо
* Тази секунда
* И третото

или допълнителни символи:

+ Първа точка
+ Втора точка
+ Трета точка

Ако искаме да създадем подсписък, ще поставим два от предишните символи вместо един, три за подсписък и т.н.

- Купува
- - Мляко
- - Бисквитки

Може и с отстъп (няколко празни интервала).

Подредени списъци

Подредените списъци се създават чрез поставяне на число, последвано от точка и след това елемента:

1. Първото нещо
2. Това следва
3. И това по-късно

Или също със скоба вместо точката:

1) Елемент 1
2) Елемент 2

За да добавите подсписъци, трябва да добавите отстъп в зависимост от нивото, което искаме да достигнем. Обичайното нещо е 4 празни интервала или каквото даде клавишът tab (ако го натиснеш, курсорът се премества надясно). В следващия пример Подготовката и Инсталацията са най-вляво, докато междинните точки са четири интервала отпред:

1. Подготовка:
    1. ISO се изтегля.
    2. Записан е на USB.
2. Монтаж:
    1. USB е поставен в устройството.
    2. То...

Ще изглежда така:

1. Начин на приготвяне:
   1. ISO се изтегля.
   2. Записва се на USB.
2. Инсталация:
   1. USB е поставен в оборудването.
   2. ТОЙ..

Имайте предвид, че подредените списъци в Markdown винаги следват ред, никога по-добре казано. Може да се създаде с 1., 1., 1. и ще видите 1., 2., 3.. За да ги прекъснете, трябва да добавите текст между тях с двоен нов ред. И въпреки това, ако след това поставите 2., ще продължи с броенето.

Списъци с данни

Списъците с данни са тези, в които даден термин е последван от определение и могат да бъдат създадени по следния начин (не се поддържат от много зрители):

Срок 1
: Определение 1

Срок 2
: Определение 2а
: Определение 2b

Списък със задачи

Можете да създавате списъци със задачи с неподреден символ за списък ('-', '*' или '+'), интервал и квадратни скоби. Ако са с празно място, задачата остава за изпълнение; с "x" вътре, това е направено:

- [ ] Създаване на статия
- [x] Поздравете новата година

Ще изглежда така:

• Създайте статия
• Поздравете новата година

Списъците могат да се комбинират, като тук в действие влиза въображението и нуждите на всеки един.

Връзки в Markdown

Има няколко начина за добавяне на връзки в Markdown: бързо или директно, нормално и чрез препратка. Бързият е добавете връзката такава, каквато е, с включен протокол. Например https://linuxadictos.com ще се разглежда като връзка, върху която може да се кликне, в повечето съвместими с Markdown зрители. Тогава имаме нормата на този тип език и по препратка.

Нормалната връзка се поставя с текста в квадратни скоби и връзката и нейната заглавие o подсказка (ако има, в кавички) в скоби:

[Най-добрият блог за Linux](https://linuxadictos.com "Или ние опитваме")

Връзките чрез препратка са малко по-сложни, но могат да бъдат полезни, защото ако трябва да направим промени, модифицирането на препратката ще промени всички връзки, които я използват. Синтаксисът е подобен, но текстът ще бъде поставен в квадратни скоби, последван от препратката в други квадратни скоби. Справката е посочена по-долу. По-добре с пример, отколкото с хиляда думи:

[Най-добрият Linux блог][LXA] ... ... ... [LXA]: https://linuxadictos.com

Препратките обикновено се поставят в края на документа.

Ако искаме връзката да се показва без хипервръзка, можем да я заобиколим със задни или отворени ударения (`), което е метод за екраниране, за който ще говорим по-късно. Това ще го форматира, но няма да се свърже с нищо.

Връзки към ID

Markdown също ви позволява да създавате връзки към елементи с ID. Първият начин да го направите е този, който се споделя най-много, но никога не е работил за мен: {#el-id} трябва да се добави към заглавките отзад и връзката, вместо URL, трябва да включва идентификатора. Например [към изображения](#images) ще доведе до следващата точка, ако вашият Markdown е „## изображения в Markdown {#images}“.

Има два други начина за добавяне на връзки към идентификатори:

• Връзки към автоматични заглавки: Някои текстообработващи програми и някои зрители го поддържат, добавят идентификатора автоматично. Ако заглавието е "A test", идентификаторът е същият, но всички с малки букви и заместват интервалите с тирета. Синтаксисът трябва да бъде:

[Текст, който искаме да показва] (#a-test)

• Връзки с HTML ID: този метод добавя таг (като "a", но не е задължително) с желания идентификатор и без никакъв текст между отварящите и затварящите тагове, така че да действа само като препратка (). Връзката ще бъде точно същата като в предишната точка.

Ако това, което търсим, е да се върнем в горната част на документа, достатъчно е да поставим решетка между скобите.

Естетически трик: ако добавим някъде в кода <style>* {scroll-behavior: smooth}</style>, ще видим денивелацията; няма да скочи. Проблемът с това е нещо, което ще обясня по-късно: някои обхвати може да показват тази линия такава, каквато е, вместо да я скриват.

Изображения в Markdown

Ако сте разбрали предишната точка, ще разберете и тази. Изображенията се добавят почти по същия начин като връзките, с основната разлика, че удивителният знак е поставен пред него. Например:

![Тапети за Linux Mint](https://www.linuxadictos.com/wp-content/uploads/Fondos-de-screenla-de-Victoria.png „Налично през януари“)

От горното:

• ! показва, че това е изображение.
• [] Те съдържат алтернативния текст, атрибута "alt" на HTML.
• () Те съдържат връзката към изображението, HTML атрибута "src".
• Можете да поставите информативния текст, "title" в HTML, между кавички. Няма нужда.

Ако искаме изображението да води към друга страница, което е изображение с връзка, всичко, което трябва да направим, е да оградим горното в квадратни скоби и да добавим връзката зад него в скоби.

[![Тапети за Linux Mint](https://www.linuxadictos.com/wp-content/uploads/Fundos-de-screenla-de-Victoria.png „Това води до DuckDuckGo“)](https://duckduckgo.com)

Както при хипервръзките, връзките могат да се добавят чрез препратка, но в препратките към изображения те започват с удивителния знак.

Запознанства

Цитатите в Markdown се създават чрез започване на параграф със символа по-голямо от, например, Pablinux каза:

> Мисля, че тогава... Кога го ядеш?

Ще покаже:

Мисля, тогава... Кога ядете?

Ако трябва да вложим кавички, ще се използват повече от символи.

> Оригинален цитат
>
>> Какво беше споменато в цитата

Ще изглежда така:

Оригинален цитат

Това, което беше споменато в цитата

И ако искаме цитатът да включва празни редове, всеки от тях трябва да включва символа пред тях, включително тези, които са празни:

> Първа остроумна фраза
>
> Край на срещата

ще покаже:

Първа остроумна фраза

Край на цитата.

Код

Кодът се добавя с табулатор или четири празни интервала пред него:

(tab)sudo pacman -Syu

Ако поставите три ударения и името след тях, някои зрители ще покажат кода със специални цветове и дори името на езика ще се покаже в някои зрители.

``` питон
def тест ():
    Здравейте
```

Ще покаже нещо подобно:

Хоризонтални линии

Хоризонталните линии в Markdown могат да бъдат създадени, като се оставят само 3 или повече звездички (***), тирета (—) или долни черти (___) на линия. Резултатът е следният:

изготвят

Таблиците в Markdown се създават основно чрез рисуване на тяхна картина:

|Първи|Втори|Трети|
|:------|:------:|------:|
|Първо поле|Второ поле|Трето поле|
|Нещо|Нещо 2|Нещо 3|

Ще покаже (но в различен формат):

Няма значение какъв размер оставяме в клетките.; езикът ще ги форматира. Във втория ред, може би най-важният, можем да посочим, че текстът е подравнен вляво, в центъра или вдясно. Двоеточие (:) показва къде отива текстът, точно обратното, когато искаме да го центрираме, трябва да поставим двоеточието пред и зад редовете.

Математически формули

Markdown също ви позволява да добавяте математически формули. Например можете да включите онлайн уравнение със знака за долар отпред и отзад: $x2+y2=z^2$. Също така блокове с два долара:

$$\sum_{i=0}^ni^2 = \frac{(n^2+n)(2n+1)}{6}$$

Резултатът от горното изглежда така във VSCode (със скоба пред второто n, което пропуснах):

Екраниране на знаци в Markdown

Понякога може да се наложи да "избягате" някои знаци. Например, ако поставим # в началото на ред и след това интервал, това ще създаде h1. Можем да избегнем това, като поставим обратната наклонена черта отпред, както следва:

\# Заглавие

И така щеше да излезе както е, без форматиране и без символа за изход. Има още няколко начина, но този е най-използваният и е същият като другите езици.

Markdown с HTML

Markdown частично поддържа HTML тагове и CSS правила, но не бих заложил на това. Не всички зрители показват нещата еднакво и е важно да имате това предвид. Например, ако използваме GitHub Markdown и искаме да подравним изображение, използвайки <img align="left"> Ще го накараме да "плува" - плаващ означава, че това, което е отдолу, се издига и се поставя до него - вляво. Може да се постави от противоположната страна с помощта на right, но централната опция не работи, освен ако не е обвита в блоков таг като или .

Но може да е вариант. Ако искаме да поставим текст в червено, можем да изтеглим HTML и CSS, да го обградим с контейнер тип span и вграден (в тага) да добавим CSS правилата в атрибута "style". Може да бъде полезно, например, ако искаме да контролираме размера на изображение, но както казах, не винаги работи.

Кога НЕ трябва да използвате Markdown

Markdown е това, което е, и е проектиран да създава съдържание бързо и за много специфична употреба. Може да се използва за лични бележки или като HTML препроцесор, но Не трябва да го използвате, ако трябва да работите в група, която не го използва. Най-разпространеното е използването на текстообработващи програми, по-точно Word и неговия .docx, така че не бих използвал Markdown, ако планирам да споделя работата си. Сигурно дори не знаят как да ги видят, освен ако не им дадем линк към статия като тази ;)

Markdown редактори за Linux

Тази статия е по-дълга от очакваното и може би си струва да я оставите за друга публикация. Може би ще е добра идея да споменем някои мимоходом, като напр Джоплин, апостроф или Visual Studio Code за тези, които искат да имат всичко на едно място. Подобно на визуализаторите, някои програми за преглед на документи по подразбиране могат да показват тяхното съдържание.

Каквото и да изберете, струва си да използвате Markdown за лични бележки. Пробвай и ще ми кажеш.

Обобщаваща таблица