✅ Cum se scrie cu Markdown și diferențele sale cu HTML.

Cuprins

,
, etc, din antet.
În Markdown este foarte simplu, trebuie pur și simplu să plasați caracterul numeric (#) ca prefix la antet, cu cât mai multe dintre acestea au gradul inferior, antetul va fi de maximum 6.
De exemplu un antet

Sintaxă de backtick triplă

Sintaxa pre-spațiere

Ce este Markdown
Este definit la fel de mult ca software-ul scris în Pel, care convertește textul scris în HTML și în plus, la sintaxa utilizată pentru a ajunge la rezultatul HTML pe care îl așteptăm. O sintaxă concepută pentru a fi simplă pentru oricine dorește să scrie pe web, fără a fi nevoie să o cunoască.
Astăzi, majoritatea managerilor de conținut și chiar mulți clienți de e-mail acceptă utilizarea sintaxei Markdown, în mod nativ, cu intenția de a facilita crearea de text formatat fără a fi nevoie să implementați stiluri sau să cunoașteți HTML. Acești manipulatori folosesc un analizor pentru a converti textul Markdown în HTML.
MarkDown și documentație
Este foarte util să învățați multe instrumente de documentare din markdown; wikia, onenote, evernote, în aer liber îl susțin în mod nativ sau cu ajutorul unor terți. Este important să aveți documentația proceselor și a posibilelor probleme, dar și mai important este să o păstrați curată și curată chiar și de pe consolă, iar marcajul este aici pentru a ne ajuta cu ea.
Paragrafele
Dacă am scrie în mod normal într-un editor comun, pentru a defini un paragraf, am apăsa pur și simplu câteva:

introduce
Și vom vedea cursorul nostru mergând câteva rânduri mai jos pentru a scrie într-un nou paragraf.
În HTML este cunoscut sub numele de
din paragraf.
În Markdown este la fel de ușor ca într-un editor normal.
În plus, avem avantajul că o singură întrerupere de linie nu separă textul în mai multe rânduri, dacă scriem așa ceva:
Un text. Un alt text.
Va arăta astfel:
Un text. Un alt text.
Utilizarea mai multor linii de separare se reduce, de asemenea, la un singur spațiu de separare între paragrafe
Anteturi
Într-un editor normal, am avea nevoie de bara de instrumente pentru a defini un stil de titlu pentru un text sau, dacă vă simțiți un pic dezordonat, ar fi suficient să mergeți la dimensiunea fontului și să îl faceți îndrăzneț.
În HTML sunt cunoscute sub numele de
,
, etc, din antet.
În Markdown este foarte simplu, trebuie pur și simplu să plasați caracterul numeric (#) ca prefix la antet, cu cât mai multe dintre acestea au gradul inferior, antetul va fi de maximum 6.
De exemplu un antet (cel mai mare) și unul ar fi scrise astfel:
# Antet mare ### Antet mic
iar rezultatul va fi așa.

Antet excelent
Antet mic
Separatoare
Separatoarele nu sunt în mod normal posibile pentru a trage în editori simpli.

MARI
În HTML devin de reguli orizontale.
Acestea sunt delimitate prin tastarea a 3 sau mai multe asteriscuri sau cratime. Pot fi urmate sau separate de un spațiu, este indiferent.
* * * *** - - - ---
Accent
Această formatare este cunoscută sub numele de italic și bold.
În HTML ar fi Da .
Pentru a crea text cu format italic, trebuie doar să înconjurați textul între asteriscuri sau subliniere, iar pentru caractere aldine între duble:
* text italic. * _ text italic._ ** text aldin. ** __ text gras .__
Ar arăta cam așa:
text cursiv. text îndrăzneț.
Strikethrough
Acest lucru vă permite să plasați text ca și cum l-am fi străbătut, folosit foarte mult pentru controlul versiunii. o Erori care au fost corectate într-o aplicație sau sistem.
În HTML ar fi de la strikethrough.
Este suficient să înconjurați textul între majuscule duble sau tilde:
~~ text strikethrough. ~~
Această opțiune nu este un standard și este posibil să nu funcționeze în toți editorii.
Citate
Stilul de citare nu este de obicei găsit cu ușurință într-un editor de text comun
În HTML ar fi
.
Trebuie doar să plasăm caracterul „mai mare decât” (>) ca prefix la textul care urmează (similar cu adresarea în linux)
> Acesta este un citat.
Ar arăta:

Acesta este un citat.

Liste
Pentru a defini o listă de obiective, de obicei folosim funcționalitatea gloanțelor pentru liste fără ordine specifică și liste numerotate.
În HTML ar fi pentru liste neordonate, pentru liste comandate și pentru a defini fiecare element din listă.
În Markdown le definim pur și simplu prin prefixarea fiecărui element cu un asterisc (*), liniuță (-) sau simbolul plus (+) pentru liste neordonate. Pentru listele ordonate prefixăm cu numărul corespunzător și un punct:
* Scrieți un tutorial * Publicați-l în Solvetic. 1. Tutorial nou. 3. Alegeți o secțiune și un nivel. 2. Corectați formatele și publicați.
Ar arăta astfel:

Scrie tutorial.

Postează-l pe Solvetic.

Tutorial nou.

Alegeți o secțiune și un nivel.

Corectați formatele și publicați.

În listele enumerate ierarhia numărului nu este respectată, va fi utilizată poziția din cadrul acestora.
Link-uri
Plasarea de linkuri este extrem de utilă și importantă, deoarece vă permite să faceți referire la conținut la unele documente externe sau la un tutorial.
Exemplu:
Serverul Nginx a fost securizat cu fail2ban folosind [tutorial-solvetic] (http://www.solvetic.com/tutoriales/article/1963-instalar-fail2ban-y-asociarlo-con-ssh-y-nginx/)
Am pus între paranteze [] textul pe care îl dorim are legătura și apoi îl plasăm între paranteze () legătura de destinație.
Dacă preferați să o faceți într-un mod mai ordonat decât să aveți referințele în mijlocul textului, o puteți face și în felul următor:
Serverul Nginx a fost securizat cu fail2ban folosind [1] ……… [1]: http://www.solvetic.com/tutoriales/article/1963-instalar-fail2ban-y-asociarlo-con-ssh-y- nginx /
O altă opțiune ar fi:
Serverul Nginx a fost securizat cu fail2ban folosind [fail2ban-nginx-solvetic] ……… [ssh-nginx-solvetic]: http://www.solvetic.com/tutoriales/article/1963-instalar-fail2ban-y-asociarlo - con-ssh-y-nginx /
Acum adăugați imagini.
Imagini
Putem adăuga imagini aproape similare cu linkurile adăugând un! Înaintea fiecăruia, trebuie să subliniez faptul că nu le pot vedea de la un terminal, nu direct.
! [text alternativ] (imagine-URL)
Putem folosi aceleași opțiuni ale link-urilor dacă dorim să o organizăm mai mult.
Placi
De obicei, pun datele de acces în tabele de servere sau servicii.
Pentru a face acest lucru, trasăm liniile tabelului cu țevi (|) pentru a delimita coloanele și cratimele (-) pentru a separa antetul de restul rândurilor:
| Serviciu | Utilizator | Cheie | | ------------- | --------- | ----------- | | FTP | solvetic | aw-D.wak | | SSH | admin | 2 -.- am, |
Am avea așa ceva:

Conductele nu trebuie aliniate, iar „muchiile” sunt opționale, de exemplu:
Rubrica 1 | Titlul 2 --- | --- să încercăm | ceva să încercăm câteva | altceva. Aceasta ar genera același tabel.
De asemenea, puteți alinia textul din coloanele dvs. plasând simbolul colonului ( pe separatorul făcut pe cratimă din partea în care doriți să fiți aliniat:
| Aliniere la stânga. | Centrat | Aliniat la dreapta. | |: ------------------- |: --------: | ----------------- -: | | test | test | test |
Nu toți editorii acceptă tabele în Markdown.
Cod
Putem evidenția codul nostru cu markdown și diferă de la o limbă la alta.
Sintaxă de backtick triplă

Plasarea acestui tip de blocuri este foarte ușoară, trebuie doar să închidem blocul de cod pe care dorim să îl introducem.e 3 backticks ("" ") urmat de numele limbii căreia îi aparține codul pe care doriți să îl plasați:
"" limba x = y … ""
Un exemplu de cod JavaScript ar arăta cam așa:
"" js function test () {console.log ('testing!')} "
Acest lucru ar genera un bloc frumos de cod cu sintaxă evidențiată pentru javascript:
test de funcție () {console.log ('testare!')}

Sintaxa pre-spațiere

O altă modalitate de a plasa text sau cod pre-formatat, dar fără limbajul specificat este prin „indentarea” textului nostru cu 4 spații, l-am scrie astfel:
x = y // observați că există 4 spații între margine și ceea ce scriem.
vom avea acest rezultat:
x = y // observați că există 4 spații între margine și ceea ce scriem.
Standardul acceptă opțiunea numai cu prespacing.
ConcluziiUn sistem bun de documentare trebuie să fie rapid, flexibil și simplu. Punctele pe care reducerea le acoperă într-un mod foarte bun, nu trebuie să uităm sintaxa sa curată pentru ochi, ceva de care să ținem cont dacă dorim să examinăm documentația de la un terminal folosind VIM / EMACS. Intrarea are o abordare pentru administratorii de sistem, dar poate fi foarte utilă pentru toate tipurile de profesioniști sau studenți. Sper că orice îndoială sau sugestie a fost clarificată, lăsați-o în comentarii.V-a plăcut și ați ajutat acest tutorial?Puteți recompensa autorul apăsând acest buton pentru a-i oferi un punct pozitiv