Markdown Ins și Outs

Markdown este un limbaj șocant de markup simplu, care vă permite să scrieți, folosind un format simplu de citit, ușor de scris, simplu text. Acest format poate fi transformat apoi în câteva secunde într-un alt limbaj de marcare, cum ar fi HTML!

Dacă nu sunteți familiarizați cu ea, permiteți-mi să vă învăț astăzi!

Markdown are o treabă fantastică de a ieși din cale.

Markdown are o treabă fantastică de a ieși din cale. Sunt sigur că toată lumea a subliniat, într-un anumit moment, un text într-un document cu text simplu prin faptul că înconjoară fraza cu un asterisc *, cum ar fi *. Exact cum funcționează în Markdown! Acordând un accent deosebit (bolding un cuvânt) este la fel de simplu ca ** dublarea pe asterix **.

Nu este o surpriză faptul că filozofia lui Markdown este de a produce conținut, care poate fi "publicat așa cum este, fără a arăta că a fost marcat cu etichete".

Beneficiile ar trebui să fie evidente pentru oricine a încercat să scrie conținut pe bază de web și a trebuit să-și facă griji și în ceea ce privește formatarea. scrieți aici este pur și simplu prea greu de tipat, odată ce creierul este în fluxul său - să nu mai menționăm cum frenezia etichetelor HTML care afectează un document poate distruge lizibilitatea în timp ce încercați un document.

Există un număr de editori Markdown, atât pe web, cât și pe bază de desktop, dar, desigur, puteți utiliza orice editor de text vechi. Singurul avantaj pe care editorii Markdown îl oferă este o previzualizare live a codului HTML generat și, de obicei, un anumit nivel de evidențiere a sintaxei.

Dacă doriți să încercați exemplele de mai jos, consultați convertorul oficial Dingus browser.


Marcajul

alineatele

Cu Markdown, textul este convertit automat în paragrafe în care blocurile de text sunt separate printr-o linie goală. Și nu doar de câțiva
tag-uri precum WYSIWYG-urile de zile, dar semantice reale

paragrafe. E aproape ca magia neagră.

 Lorem ipsum dolor este așezat în amonte, în funcție de timpul de aderare, de la locul de muncă temporar la locul de muncă și de la alte persoane. Ut enim ad minim veniam, quis exerciții de muncă ultima lucrătoare aliquip ex a commodo consequat. Duis aute irure dolor în republicarea în voluptate comandă esse cillum dolore eu fugiat nulla pariatur. Cu excepția cazului în care nu există un prozident, sunt în culpa qui officia deserted molit anim id est laborum.

Pur și simplu devine:

Lorem ipsum dolor este așezat în amonte, în funcție de timpul de aderare, de la locul de muncă temporar la locul de muncă și de la alte persoane. Ut enim ad minim veniam, quis ex exercitarea ullamco laboris nisi ut aliquip ex ea commodo consequat.

Duis aute irure dolor în republicarea în voluptate comandă esse cillum dolore eu fugiat nulla pariatur. Cu excepția cazului în care nu există un prozident, sunt în culpa qui officia deserted molit anim id est laborum.

O mică ciudățenie cu Markdown este modul în care sunt tratate întreruperile cu o singură linie. Filozofia Markdown este că browserul ar trebui să se ocupe de pauze de linie și nimeni altcineva. Deci, următorul text:

Lorem ipsum dolor stai amet, consectetur. Adapționarea elitei, sed do eiusmod tempor incididunt.

Devine, destul de jignitor:

Lorem ipsum dolor stai amet, consectetur. Adapționarea elitei, sed do eiusmod tempor incididunt.

Dacă absolut trebuie sa introduceți o pauză de linie, se oferă o lucrare: adăugați pur și simplu două spații la capătul liniei anterioare, cum ar fi:

Lorem ipsum dolor stai amet, consectetur. Adapționarea elitei, sed do eiusmod tempor incididunt.

Un număr de "arome" Markdown se pot ocupa de pauze de linii în moduri pe care le-ați aștepta, dar mai mult despre asta mai târziu.

rubricile

Începeți un paragraf cu a #, iar paragraful devine un antet. Numarul # semnifică numărul de nivel al poziției (

,

etc)

# Heading One Acesta este un paragraf. Lorem ipsum dolor este așezat în amonte, în funcție de timpul de aderare, de la locul de muncă temporar la locul de muncă și de la alte persoane. Ut enim ad minim veniam. ## Titlul doi Acesta este un paragraf. Lorem ipsum dolor este așezat în amonte, în funcție de timpul de aderare, de la locul de muncă temporar la locul de muncă și de la alte persoane. Ut enim ad minim veniam. ### Titlul trei #### Titlul patru ##### Rubricile 5 ###### Rubricile șase

devine:

Capitolul 1

Acesta este un paragraf. Lorem ipsum dolor este așezat în amonte, în funcție de timpul de aderare, de la locul de muncă temporar la locul de muncă și de la alte persoane. Ut enim ad minim veniam.

Capitolul doi

Acesta este un paragraf. Lorem ipsum dolor este așezat în amonte, în funcție de timpul de aderare, de la locul de muncă temporar la locul de muncă și de la alte persoane. Ut enim ad minim veniam.

Capitolul trei

Capitolul patru

Capitolul cinci
Capitolul șase

O sintaxă alternativă este, de asemenea, prevăzută

și

, ca astfel:

Capitolul unu =========== Acesta este un paragraf. Lorem ipsum dolor este așezat în amonte, în funcție de timpul de aderare, de la locul de muncă temporar la locul de muncă și de la alte persoane. Ut enim ad minim veniam. Capitolul doi ----------- Acesta este un paragraf. Lorem ipsum dolor este așezat în amonte, în funcție de timpul de aderare, de la locul de muncă temporar la locul de muncă și de la alte persoane. Ut enim ad minim veniam.

blockquotes

Una dintre influențele majore ale lui Markdown este e-mailul cu text simplu, iar acest lucru este destul de evident, când vedeți că bloccotările sunt formatate exact așa cum sunt în e-mail: prefixate cu a >:

Acesta este un paragraf normal. > Acesta este un paragraf de blocaj. > Și blocajul continuă și aici.

... Care converteste la:

Acesta este un paragraf normal.

Acesta este un paragraf de blocaj.

Și blocajul continuă și aici.

Cod

Puteți delimita fragmente mici de cod inline, utilizând ' caracter în jurul codului.

Blocurile mai mari de cod pot fi definite prin simpla indentare a codului la un nivel (cel puțin o filă / patru spații) - nivelul de indentare va fi eliminat. Markdown scapă automat toate caracterele speciale din interiorul unui bloc de cod, ceea ce înseamnă că puteți copia în siguranță în blocuri de cod fără a scăpa manual < la < și > la > etc.

Acesta este un paragraf cu un pic de "COD"în ea.  Un alt paragraf, dar cu un bloc de cod deasupra lui.


Acesta este un paragraf cu un pic de "COD"în ea.

 

Un alt paragraf, dar cu un bloc de cod deasupra lui.

liste

Un alt exemplu adevărat despre cum Markdown apare în mod natural este modul în care specificați o listă. Pur și simplu porniți un paragraf cu a * (sau +, -) pentru a crea o listă neordonată. Utilizați numere, 1., 2. etc pentru liste comandate:

Voi avea nevoie de: * Șerpi * Scorpioni * Hamsteri Apoi, pot să încep planul meu de a conduce lumea: 1. Înghețați hamsteri 2. Treziți șerpi pentru a călări hamsteri 3. Rulează lumea


Voi avea nevoie:

  • şerpi
  • Scorpions
  • Hamsterii

Apoi, pot să încep planul meu de a conduce lumea:

  1. Îndepărtați hamsterii
  2. Treziți șerpi pentru a conduce hamsteri
  3. Rulează lumea

Elemente text inline

Am redactat deja textul cu caracter italitic și îndrăzneț la începutul acestui articol (* și **), cu toate acestea, puteți schimba și astericii pentru subliniere, dacă este mai mult lucru:

Iată câteva text * italic * și mai mult text _italic_. Unele ** lucruri îndrăznețe ** aici; plus un pic mai mult.

Legăturile sunt frumoase și simple în Markdown (dacă vă puteți angaja în memorie dacă este paranteza pătrată și paranteze care vin în primul rând ...):

[Google] (http://google.com)
Google

Pentru a afișa o imagine, prefixați codul de legătură cu a !:

![Logo-ul Google] (images_23 / markdown-the-ins-and-outs.png)
Logo-ul Google

Markdown nu ajunge în calea ta

Markdown este foarte indulgentă atunci când vine vorba de ruperea marcajului și folosirea doar a HTML-ului. Dacă trebuie să includeți un tabel, includeți-l în HTML. Sau, dacă doriți să scrieți linkurile în format HTML, puteți face acest lucru. Markdown este suficient de inteligent pentru a ști când intenționați să includeți cod HTML și funcționează în jurul acesteia.

Markdown, de asemenea, auto-scapă de caractere, cum ar fi &, < and > în formularul entității HTML. Chiar convertește în mod inteligent combinațiile de caractere comune în ceea ce înseamnă cu adevărat.

  • Trei puncte vor deveni automat o elipsă: ...
  • Două cratime vor deveni en-dash: --
  • Mărcile de cotație vor deveni versiunile "fancy", curlate ale acestora.

Flavors & GitHub Aromatizat Markdown

Există mai multe "arome" Markdown alternative care extind setul implicit de reguli Markdown. O extensie comună este ușor de rupere, așa cum este descris mai sus. Una dintre cele mai cunoscute arome Markdown este GutHub's Flavored Markdown. Acest lucru este folosit pentru a marca utilizatorii de intrare oriunde pe site-ul lor. Pe lângă includerea suportului de rupere îmbunătățit și a mai multor personalizări specifice GitHub, caracteristica mea preferată este alternativa la codarea de garduri, care vă permite, de asemenea, să specificați o sintaxă pentru evidențiere. Simplu înconjoară un bloc de coduri cu " pe ambele părți, inclusiv limba de la început, după cum urmează:

„php "

Conversie

Convertorul Tuts + Markdown poate fi găsit aici.

Convertorul oficial este scris în Perl și este disponibil pentru descărcare de pe pagina de pornire Markdown de la Daring Fireball. Există și alți convertori Markdown, pentru o multitudine de limbi diferite - de la C ... la Ruby ... la JavaScript ... la PHP. O listă completă a implementărilor poate fi găsită pe Wikipedia.

O aplicație Ruby populară este RedCarpet, bazată pe biblioteca C, Sundown, care oferă o modalitate foarte simplă de a personaliza ieșirea codului HTML generat pentru a produce propria "aromă" a Markdown.

Recent, am folosit această bibliotecă pentru a crea un convertor Markdown, care acceptă GitHub Flavored Markdown (pentru a permite specificarea unui limbaj de cod pentru evidențierea sintaxei) și transmite HTML-ul convertit în stilul specific cerut de site-urile Tuts +. Convertorul Tuts + Markdown poate fi găsit aici. Dacă ați scris vreodată un tutorial pentru acest site, folosiți-l cu siguranță!

De fapt, acest articol a fost scris în Markdown, folosind editorul popular Mou Markdown pentru OSX.

Cod