Въведение в Markdown

Маркдаун

Markdown е инструмент за преобразуване на текст в HTML. Днес тя се превърна в де факто синоним за клас леки езици за описание на маркиране. Той използва синтаксис за форматиране на обикновен текст. Идеята на Markdown беше да направи писането на уеб страници и особено на записите в блога толкова лесно, колкото писането на имейл. По време на ноември 2017 г. целта е постигната и Markdown, както и нейните производни Asciidoc, Asciidoctor и Asciidoctor-pdf са широко използвани.

Markdown се фокусира само върху обикновен текст и се въздържа от всички други сложности, както се намира в HTML. Лесно е да се научи, тъй като се поддържа лесно, следователно и по-бързо, тъй като се използват минимални знаци, което води до по-малко шансове за грешка в крайна сметка. Вижте фигура 1 за основен документ, показан в редактора Markdown Stackedit. От лявата страна виждате изходния код, а от дясната съответния HTML изход. Може да забележите, че заглавията просто са маркирани с номер # според йерархичното ниво на заглавието.

Преобразуване на текст

Обикновеният текст е конвертируем в XHTML (HTML) и много други формати, използвайки инструментите на командния ред като Markdown или Pandoc. По принцип и двата инструмента създават само HTML фрагменти и записват изхода в stdout. Pandoc предлага превключвателя “-o име на файла”, за да запише HTML изхода към дадения файл. Както се вижда по-долу, изходният файл се нарича основен.html и съдържа HTML фрагмент - две заглавия и параграф.

$ pandoc -o основно.html основно.md $ котка основно.html 
Как да създадем пакети за Debian
 
Предговор
 Да отговаряш за машина означава да се грижиш както за хардуера, така и за софтуерните компоненти. Както се вижда в ежедневието като системен администратор, много по-добре е да инсталирате софтуер като софтуерен пакет, а не като куп изходни файлове. Това намалява разходите за правилно поддържане на системата. $ 

За да създаде самостоятелни HTML документи с пълен HTML заглавие, Pandoc приема превключвателя “-s”, както следва:

$ pandoc -o основно.html -s basic.md $ котка основно.html           
Как да създадем пакети за Debian
 
Предговор
 Да отговаряш за машина означава да се грижиш както за хардуера, така и за софтуерните компоненти. Както се вижда в ежедневието като системен администратор, много по-добре е да инсталирате софтуер като софтуерен пакет, а не като куп изходни файлове. Това намалява разходите за правилно поддържане на системата.   

Предимството да държите съдържанието отделно от визуалния си дисплей е, че няма да обърка външния вид на вашия сайт. Версия 1.0.1, който е разработен от Джон Грубер и Аарон Суорц е издаден през декември 2004 г. и е достъпен като безплатен софтуер (вижте връзките в края на тази статия).

Текстови елементи

Заглавия

Според съответното ниво на HTML, заглавията се изписват с номер #, както следва:

# H1 ## H2 ### H3 #### H4 ##### H5 ###### H6 

За H1 и H2 се приемат два алтернативни начина на писане:

H1 == H2 -- 

Моля, обърнете внимание, че броят на знаците за равенство или тирета трябва да съответства на броя на символите на заглавието.

Подчертаване на текст

За да се наблегне на текста се поддържат следните елементи:

• курсив: единични звездички или единични долни черти
  --
  * важно * и _също важно_
  --
• получер текст: двойни звездички или двойни долни черти
  --
  ** важно ** и __също важно__
  --
• зачеркнат текст: двойни тилди
  --
  ~~ текст ~~
  --

Списъци

Markdown поддържа неподредени и подредени списъци. Подредените списъци започват със звездичка, знак плюс или минус. Подредените списъци просто започват с цифра. За да създадете подлисти, отстъпете списъчния елемент с две интервали (Markdown, StackEdit) или четири интервали (Pandoc), както виждате по-долу:

1. плодове * ябълка * банан 2. напитки + вода + мляко 

Изображения

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

![Логото на Debian] (логото на debian.png “Лого на Debian”) 

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

Подчертаване на кода и синтаксиса

Има два варианта - вграден код и кодови блокове. Вграденият код е рамкиран в три обратни знака като „'print („ Здравей, свят!”)„ „. Блоковете на кода също започват и завършват с три обратни знака, но на отделни редове, както следва:

"print (" Здравей, свят!”)"

Markdown не поддържа подчертаване на синтаксис, но диалекти като Markdown Here го правят.

Маси

Markdown не поддържа таблици, но разширения като GFM и Markdown Тук го правят.

Блок цитати

Блок кавичките просто започват със знак „>“. Става доста удобно да се цитира текст.

> "О! абсурдно е да има твърдо правило за това какво трябва> да чете и какво не трябва. Повече от половината съвременна култура зависи> от това, което човек не трябва да чете.">> Важността да бъдем сериозни. (Оскар Уайлд) 

Връзки

Връзките се отнасят до други документи или до раздели в настоящия. Стилът на писане е подобен на изображенията и се състои от описанието на връзката в квадратни скоби и URL адреса в обикновени скоби.

[Аз съм вградена връзка в стил] (https: // linuxhint.com) 

Освен това можете да добавите алтернативен текст:

[Аз съм вградена връзка с допълнителен текст] (https: // linuxhint.com “LinuxHint”) 

На връзки може да се направи препратка, както следва:

[LinuxHint] [1] ... малко текст ... [1]: https: // linuxhint.com 

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

Заключение

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

Препратки

• StackEdit, https: // stackedit.io / редактор
• Pandoc, http: // pandoc.организация /
• Markdown, https: // daringfireball.net / projects / markdown /
• Маркдаун Cheatsheet, https: // github.com / adam-p / markdown-here / wiki / Markdown-Cheatsheet