Как да пиша с Markdown и неговите разлики с HTML.

Въведете

от параграф.
В Markdown е толкова лесно, колкото в нормален редактор.
Освен това имаме предимството, че един прекъсване на ред не разделя текста на няколко реда, ако напишем нещо подобно:

 Текст. Друг текст.

 Текст. Друг текст.

,

и т.н., от заглавката.
В Markdown е много просто, просто трябва да поставите числовия знак (#) като префикс към заглавката, колкото повече от тях имат по -ниската степен, заглавката ще бъде до максимум 6.
Например заглавка (най -големият) и един ще бъдат написани така:

 # Голяма заглавка ### Малка заглавка

и резултатът ще бъде такъв.

Страхотен заглавие
Малка заглавка

Разделители
Обикновено разделителите не могат да бъдат нарисувани в прости редактори.

Увеличете

В HTML те стават хоризонтални правила.
Те са разделени чрез въвеждане на 3 или повече звездички или тирета. Те могат да бъдат последвани или разделени с интервал, безразличен е.

 * * * *** - - - ---

Акцент
Това форматиране е известно като курсив и удебелен шрифт.
В HTML би било така Y .
За да създадете текст с курсив, просто трябва да заобиколите текста между единични звездички или долни черти, а за удебелен между двойни:

 * курсив. * _ курсив ._ ** удебелен текст. ** __смелен текст .__

Ще изглежда така:
курсив. удебелен текст.
Зачертаване
Това ви позволява да поставяте текст, сякаш го зачертаваме, използвани много за контрол на версиите. o Грешки, които са коригирани в приложение или система.
В HTML би било от зачертаване.
Достатъчно е текстът да бъде заобиколен между двойни главни букви или тилди:

 ~~ зачертан текст. ~~

Тази опция не е стандартна и може да не работи във всички редактори.
Цитати
Стилът на цитиране обикновено не се намира лесно в обикновен текстов редактор
В HTML би било така

.
Просто трябва да поставим знака "по -голямо от" (>) като префикс към текста, който следва (подобно на адресирането в Linux)

 > Това е цитат.

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

Това е цитат.

Списъци
За да дефинираме списък с цели, обикновено използваме функционалността на маркерите за списъци без конкретен ред и номерирани списъци.
В HTML би било така за неподредени списъци, за подредени списъци и за да дефинирате всеки елемент в списъка.
В Markdown ние ги дефинираме просто като поставяме всеки елемент със звездичка (*), тире (-) или символ плюс (+) за нередени списъци. За подредени списъци ние поставяме префикс със съответния номер и точка:

 * Напишете урок * Публикувайте го в Solvetic. 1. Нов урок. 3. Изберете раздел и ниво. 2. Правилни формати и публикуване.

Това би изглеждало така:

• Напишете урок.
• Публикувайте го в Solvetic.

• Нов урок.
• Изберете раздел и ниво.
• Правилни формати и публикуване.

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

 Nginx сървърът е защитен с fail2ban с помощта на [tutorial-Solticic] (http://www.solvetic.com/tutoriales/article/1963-instalar-fail2ban-y-asociarlo-con-ssh-y-nginx/)

Слагаме скоби [] текстът, който искаме, има връзка и след това поставяме между скоби () връзката към местоназначението.
Ако предпочитате да го направите по по -подреден начин, отколкото да имате препратките в средата на текста си, можете да го направите и по следния начин:

 Nginx сървърът е защитен с fail2ban с помощта на [1] ……… [1]: http://www.solvetic.com/tutoriales/article/1963-instalar-fail2ban-y-asociarlo-con-ssh-y- nginx/

Друг вариант би бил:

 Nginx сървърът е защитен с fail2ban с помощта на [fail2ban-nginx-Solvertic] ……… [ssh-nginx-solutiontic]: http://www.solvetic.com/tutoriales/article/1963-instalar-fail2ban-y-asociarlo- con-ssh-y-nginx /

Сега добавете изображения.
Изображения
Можем да добавим изображения, почти подобни на връзки, като добавим a! Преди всеки трябва да подчертая, че не мога да ги видя от терминал, а не директно.

 ! [алтернативен текст] (URL адрес на изображението)

Можем да използваме същите опции на връзките, ако искаме да ги организираме по -добре.
Табла
Обикновено поставям данните за достъп в таблици на сървъри или услуги.
За да направите това, чертаем линиите на таблицата с тръби (|), за да ограничим колоните и тирета (-), за да отделим заглавката от останалите редове:

 | Услуга | Потребител | Ключ | | ------------- | --------- | ----------- | | FTP | решаващ | aw-D.wak | | SSH | admin | 2 -.- сутринта, |

Ще имаме нещо подобно:

Тръбите не е необходимо да се подравняват, а "ръбовете" са по избор, например:

 Заглавие 1 | Заглавие 2 --- | --- нека опитаме | нещо нека опитаме | нещо друго. Това ще генерира същата таблица. 

Можете също да подравните текста в колоните си, като поставите символа на двоеточието ( на разделителя с тирета от страната, която искате да бъде подредена:

 | Подравнен вляво. | Центрирано | Подравнен вдясно. | |: ------------------- |: --------: | ----------------- -: | | тест | тест | тест |

Не всички редактори приемат таблици в Markdown.
Код
Можем да подчертаем кода си с отметка и той се различава от един език на друг.

Синтаксис с тройна обратна връзка

Поставянето на този тип блокове е много лесно, просто трябва да оградим кода, който искаме да въведем.e 3 гърба ("") последвано от името на езика, към който принадлежи кодът, който искате да поставите:

 „език x = y …“

Пример за JavaScript код би изглеждал така:

 „„ js функция test () {console.log („тестване!“)} “

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

 function test () {console.log ('testing!')}

Синтаксис преди интервалите

Друг начин за поставяне на предварително форматиран текст или код, но без посочен език е чрез „отстъпване“ на нашия текст с 4 интервала, бихме го написали така:

 x = y // забележете, че има 4 интервала между полето и това, което пишем.

ще имаме този резултат:

 x = y // забележете, че има 4 интервала между полето и това, което пишем.

Стандартът приема само опцията с предварително разположение.
ИзводиДобрата система за документиране трябва да бъде бърза, гъвкава и проста. Точките, които отстъпката обхваща по много добър начин, не трябва да забравяме чистия си синтаксис за очите, нещо, което трябва да вземем предвид, ако искаме да прегледаме документацията от терминал, използващ VIM / EMACS. Записът има подход за системните администратори, но може да бъде много полезен за всички видове професионалисти или студенти. Надявам се, че всяко съмнение или предложение е изяснено, оставете го в коментарите.Хареса ли ви и помогнахте на този урок?Можете да възнаградите автора, като натиснете този бутон, за да му дадете положителна точка