Utilizați Markdown pentru scrierea ușoară pe Web

În timp ce ascultam o grămadă de podcast-uri Mac-centrice, în special în fluxurile de lucru cu Mac, am dat peste un instrument care a fost în jur de ceva timp, dar nu este încă extrem de popular pentru toată lumea. Instrumentul este numit Markdown și a fost creat de John Gruber (Daring Fireball faima). Cel mai bun mod de a explica este primul paragraf din descrierea lui Markdown pe pagina lui Gruber:

Markdown este un instrument de conversie text-la-HTML pentru scriitorii web. Markdown vă permite să scrieți utilizând un format simplu de text ușor de citit și ușor de scris, apoi să-l convertiți la XHTML (sau HTML) valabil structural..

Da, asta este pe scurt. Înainte de a sari în modul de utilizare a acestui instrument minunat pe Mac și Windows, s-ar putea să te întrebi ce înseamnă un instrument ca acesta este de fapt.

Care-i rostul?

La început nu am primit motivul pentru care am folosit Markdown. Cool, poți transfera chestii de text simplu în HTML, dar cine naiba mai folosește HTML? Ei bine, dacă sunteți un scriitor de web utilizați HTML în fiecare zi, fie că știți sau nu și dacă ați folosit WordPress sau orice alt CMS pentru orice perioadă de timp ai probabil că a trebuit să tweak unele HTML.

Dacă utilizați WordPress, nu este nimic mai agreabil decît editorul WYSIWYG devenind prea util cu etichetele HTML în fundal, în esență distorsionând formatarea. Markdown vă poate ajuta transformând fișierul text într-un HTML valid. Acest lucru vă permite să inserați HTML-ul în editorul HTML păstrând astfel formatarea greu câștigată. Atât de frumos. reclamă

De asemenea, există ceva de spus pentru portabilitatea documentelor. HTML este un tip agnostic de marcare a documentelor și poate fi redat în orice browser web destul de greu. Cu utilizarea în continuare a mai multor sisteme de operare și dispozitive aflate în sălbăticie (iOS, Android, BlackBerry, Windows, Mac, Linux etc.) este nevoie de un format standard pentru text. Markdown vă ajută acest lucru, permițându-vă să standardizați toate formatele de notare fără a vă bloca în anumite forme de proprietate. Doar fișiere HTML și txt.

Să o folosim, să o facem noi?

Markdown este destul de greu de folosit și dacă aveți vreo experiență de confuzie cu software-ul și HTML-ul va fi un moment. Markdown este scris în Perl, deci dacă nu aveți Perl pe mașina dvs. Windows, puteți descărca și instala Strawberry Perl de aici. Dacă sunteți utilizator Mac, Perl este deja instalat pentru dvs..

Citiți Următorul

10 mici schimbări pentru a vă face casa să vă simțiți ca o casă

Ce face oamenii fericiti? 20 de secrete ale oamenilor "întotdeauna fericiți"

Cum de a vă îmbunătăți abilitățile transferabile pentru un schimbător de carieră rapid

Derulați în jos pentru a continua să citiți articolul

Apoi, mergeți la Daring Fireball și apucați scriptul Markdown.pl, dezarhivați-l și puneți fișierul Markdown.pl în directorul pe care îl veți folosi pentru a crea și transforma fișierele text de intrare.

Acum partea distractivă; învățați cum să utilizați sintaxa și să creați fișierul text de intrare.

Marcă de sintaxă

Voi explica pe scurt câteva dintre fragmentele de sintaxă cele mai utilizate care vă vor scoate de pe urma unui joc cu Markdown. Dacă doriți întregul shebang, mergeți la Daring Fireball pentru a obține o listă detaliată a tuturor minunatelor sintaxii Markdown.

Cap

Anteturile de antet (h1, h2, h3, etc) sunt ușor de creat în documentul dvs. text. Pentru a semnifica eticheta h1, “sublinia” textul cu semnul '=': Publicitate

Acesta este un antet h1 =================== 

sau pentru h2 folosiți caracterul '-':

Acesta este un antet h2 ------------------- 

Nu este necesar să plasați aceeași valoare a caracterelor "=" sau "-" sub titlul; orice număr va fi datorat producerii etichetelor antetului.

Gloanțe și liste

Cred că în gloanțe și liste, așa că e frumos că Markdown îi ocupă bine. Pentru a insera un glont, adăugați un asterisc pe linia dvs. astfel:

* Acesta este punctul meu de vedere 

De asemenea, puteți utiliza caracterele "+" sau "-" ca gloanțe.

Listele comandate sunt ușor de asemenea:

1. Numărul unu 2. Numărul doi 3. Numărul trei ... acum ai luat-o! 

Dacă doriți mai multe paragrafe sub un glonț sau un număr doar linia de prima linie a fiecărui paragraf sau linia toate liniile dacă doriți să arate mai bine: Publicitate

1. Aici este primul punct pe care încerc să-l fac despre listele numerotate. Apropo, probabil ar trebui să menționez și asta. 2. Următorul punct 

Link-uri

Unul dintre lucrurile mele favorite ale lui Markdown este modalitatea ușoară de a introduce link-uri. Mai întâi, legați cuvântul sau fraza pe care ați dori să o faceți “clickable” și apoi urmați-o cu un URL parantez:

[click aici] (http://www.google.com/) 

Ieșirea în HTML

După ce ați creat fișierul text, este timpul să îl transmiteți scriptului Markdown.pl pentru a vă produce ieșirea HTML. Dacă nu ați creat un fișier text pentru a testa, puteți descărca fișierul text rapid pe care l-am creat pentru a-l încerca.

Plasați fișierul text în același director ca și scriptul Markdown.pl (puteți să transmiteți argumentele cu calea corectă dacă doriți, doar pentru a face mai ușoară). După aceasta se deschide promptul de comandă în Windows sau terminalul de pe Mac sau Linux și navigați la dosarul cu fișierul de intrare.

Pentru a crea ieșirea direct în fereastra terminalului, utilizați următoarea comandă:

perl Markdown.pl input.txt

Acesta va analiza apoi fișierul text și va scoate marcajul HTML valid la terminal. Dacă doriți ca oaput-ul să fie îndreptat spre un tip de fișier complet separat HTML, faceți următoarea comandă: Publicitate

perl Markdown.pl input.txt> output.html

Aceasta va crea fișierul HTML output.html în orice director în care vă aflați în prezent.

Înfășurați-o

Permiteți-mi să spun doar că, dacă credeți că Markdown este interesant și înțelegeți utilitatea acestuia, vă recomand că dacă scrieți ceva, ar trebui să îl scrieți cu Markdow

n sintaxă. Este cross-platform, open source, gratuit și compatibil cu tot. Pentru mine este un schimbător de joc și mă simt ca și cum aș fi puțin în urmă să nu-l folosesc mai devreme. Încă o dată, există mult mai mult pentru sintaxa decât am evidențiat aici, așa că verificați Daring Fireball pentru mai multe.

Apropo, am scris întregul articol folosind Markdown și dacă vrei să vezi sintaxa îl poți descărca aici.