Bruk Markdown For Easy Web Writing

Når jeg lytter til en haug med Mac-sentriske podcaster i det siste, spesielt på arbeidsflyter med Mac, har jeg kommet over et verktøy som har eksistert en stund, men er fortsatt ikke ekstremt populær hos alle. Verktøyet kalles Markdown og ble skapt av John Gruber (Daring Fireball fame). Den beste måten å forklare det er første ledd fra Markdowns beskrivelse på Mr. Grubers side:

Markdown er et tekst-til-HTML-konverteringsverktøy for webforfattere. Markdown lar deg skrive ved hjelp av et lettlest, lett å skrive vanlig tekstformat, og konvertere det til strukturelt gyldig XHTML (eller HTML).

Ja det er det i et nøtteskall. Før jeg hopper i hvordan du bruker dette fantastiske verktøyet på Mac og Windows, kan du lure på hva poenget med et verktøy som dette egentlig er.

Hva er poenget?

Først fikk jeg ikke grunn til å bruke Markdown. Cool, du kan overføre enkle tekstspor til HTML, men hvem i helvete bruker HTML lenger? Vel, hvis du er en webforfatter, bruker du HTML hver eneste dag, enten du vet det eller ikke, og hvis du har brukt WordPress eller noe annet CMS for en lengre tid, har du sannsynligvis måtte tweak noen HTML.

Hvis du bruker WordPress, er det ikke noe mer å forstå enn WYSIWYG-editoren blir for nyttig med HTML-koder i bakgrunnen, og ødelegger formateringen. Markdown kan hjelpe deg ved å transformere tekstfilen din til gyldig HTML. Dette lar deg lime inn HTML-koden i HTML-editoren og dermed holde din hardt vant formatering. Så bra. Reklame

Det er også noe å si for dokumentportabilitet. HTML er en agnostisk type dokumentoppretting og kan gjengis i stort sett hvilken som helst crappy nettleser. Med fortsatt bruk av mange forskjellige operativsystemer og enheter ute i naturen (iOS, Android, Blackberry, Windows, Mac, Linux, etc) er behovet for et standardformat for tekst svært nødvendig. Markdown hjelper dette sammen ved å la deg standardisere alle notatformateringen uten å låse deg inn i noe proprietært format. Bare HTML og txt filer.

La oss bruke det, skal vi?

Markdown er ganske darn lett å bruke, og hvis du har erfaring med å rote aroudn med programvare og HTML, blir det et snap. Markdown er skrevet i Perl, så hvis du ikke har Perl på Windows-maskinen, kan du laste ned og installere Strawberry Perl herfra. Hvis du er en Mac-bruker, er Perl allerede installert for deg.

Les neste

10 små endringer for at huset ditt skal føles som et hjem

Hva gjør folk lykkelige? 20 hemmeligheter med "alltid glade" mennesker

Hvordan skarpe dine overførbare ferdigheter for en rask karrierebryter

Rull ned for å fortsette å lese artikkelen

Deretter går du over til Daring Fireball og tar tak i Markdown.pl-skriptet, pakker ut det og legger Markdown.pl-filen i katalogen som du vil bruke til å opprette og transformere dine inntastede tekstfiler.

Nå den morsomme delen; lære å bruke syntaksen og lage din inntastede tekstfil.

Markdown-syntaks

Jeg skal kort forklare noen av de mest brukte syntaksuttrykkene som vil få deg i gang med Markdown. Hvis du vil ha hele shebang, gå videre til Daring Fireball for å få en detaljert liste over alle niceties av Markdown-syntaksen.

overskrifter

Overskriftskoder (h1, h2, h3, etc) er enkle å lage i tekstdokumentet. Å signere h1-taggen, “understreke” Teksten med '=' -tegnet: Annonsering

Dette er en h1 header ==================== 

eller for h2 bruk '-' tegnet:

Dette er en h2 header ------------------- 

Du trenger ikke å sette samme mengde '=' eller '-' tegn under overskriften; Et hvilket som helst tall skyldes å produsere topptekstene.

Kuler og lister

Jeg tenker på kuler og lister, så det er fint at Markdown håndterer dem godt. For å sette inn en kule legger du til en stjerne på linjen din slik som denne:

* Dette er mitt poeng 

Du kan også bruke '+' eller '-' tegnene som kuler.

Bestilte lister er også enkle:

1. Nummer ett 2. Nummer to 3. Nummer tre ... nå har du det! 

Hvis du vil ha flere avsnitt under en kule eller et nummer, bare skriv inn den første linjen i hvert avsnitt eller skriv inn alle linjene hvis du vil at det skal se bedre ut: Reklame

1. Her er det første punktet jeg prøver å lage om nummererte lister. Forresten, jeg burde nok nevne dette også. 2. Neste punkt 

lenker

En av mine favoritt ting i Markdown er den enkle måten å sette inn linker. Først brak det ordet eller uttrykket som du ønsker å være “klikkbar” og følg deretter med en parentesert nettadresse:

[klikk her] (http://www.google.com/) 

Skrive ut til HTML

Etter at du har opprettet tekstfilen, er det nå på tide å sende det til Markdown.pl-skriptet for å produsere HTML-utgangen. Hvis du ikke opprettet en tekstfil for å teste, kan du laste ned hurtigtekstfilen som jeg opprettet for å prøve den.

Plasser tekstfilen din i samme katalog som Markdown.pl-skriptet (du kan sende argumentene med riktig bane hvis du vil, dette er bare for å gjøre det enklere). Etter det er det åpnet opp kommandoprompten din i Windows eller din terminal på Mac eller Linux, og naviger til mappen med din inntaksfil.

For å lage utdataene direkte i terminalvinduet, bruk følgende kommando:

perl Markdown.pl input.txt

Dette vil deretter analysere tekstfilen og sende den gyldige HTML-oppmerkningen til terminalen. Hvis du vil at ouput skal rettes mot en helt separat HTML-filtype, følger du følgende kommando: Reklame

perl Markdown.pl input.txt> output.html

Dette vil opprette HTML-filen output.html i hvilken katalog du er for øyeblikket.

Wrapping det opp

La meg bare si at hvis du tror Markdown er interessant og forstår nytten av det, foreslår jeg sterkt at hvis du skriver noe, bør du skrive det med Markdow

n syntaks. Det er kryssplattform, åpen kildekode, gratis og kompatibel med alt. For meg er det en spillveksler, og jeg føler at jeg er litt borte i å ikke bruke det før. Igjen, det er mye mer til syntaksen enn jeg har markert her, så sjekk ut Daring Fireball for mer.

Forresten skrev jeg hele denne artikkelen ved hjelp av Markdown, og hvis du vil se syntaksen, kan du laste den ned her.