4 Markdown-værktøjer til Linux-kommandolinjen

Når det drejer sig om at arbejde med filer formateret med Markdown, er det kommandolinjeværktøjerne, der er mest populære. De er lette, hurtige, kraftfulde og fleksible, og de fleste af dem følger Unix-filosofien om at gøre én ting godt.

Se fire hjælpeprogrammer, der kan hjælpe dig med at arbejde mere effektivt med Markdown-filer på kommandolinjen.

mdless

Hvis du har hængt ud på Linux-kommandolinjen i et stykke tid, er du sikkert bekendt med en tekstfilfremviser, der hedder less. Selvfølgelig kan du bruge less til at se Markdown-filer – men resultatet er en smule kedeligt. Hvordan kan du se Markdown-filer med lidt mere pift i et terminalvindue? Ved at bruge mdless.

Du kan bevæge dig rundt ved hjælp af piletasterne på dit tastatur, og mdless indeholder en ganske god søgefunktion.

Mdless viser ikke kun tekst, men gengiver også formatering som overskrifter, fed og kursiv. Den kan også vise tabeller og lave syntaksmarkering af kodeblokke. Du kan også tilpasse mdless’ udseende ved at oprette en eller flere temafiler.

Markdown lint-værktøj

Når man skriver hurtigt, laver man fejl. Hvis du glemmer en smule formatering, når du bruger Markdown (eller et andet markup-sprog), kan det give problemer, når du konverterer din fil til et andet format.

Kodere bruger ofte værktøjer kaldet linter til at kontrollere, om syntaksen er korrekt. Du kan gøre det samme for Markdown ved hjælp af Markdown lint-værktøjet.

Når du kører dette værktøj over en fil, der er formateret med Markdown, kontrollerer det formateringen i forhold til et sæt regler. Disse regler regulerer strukturen i et dokument, herunder rækkefølgen af overskriftsniveauer, forkert indrykning og afstand, problemer med kodeblokke, eksistensen af HTML i en fil og meget mere.

Reglerne kan være en smule strenge. Men ved at køre Markdown lint-værktøjet over en fil, før den konverteres til et andet format, kan man undgå den sorg, der kommer af dårlig eller inkonsekvent formatering.

mdmerge

Det kan være besværligt at kombinere filer af enhver art. Tag f.eks. en e-bog, som jeg er ved at samle. Det er en samling af essays, der først blev offentliggjort i mit ugentlige e-mail-brev. Disse essays lå i individuelle filer, og da jeg er den masochist, jeg er, kombinerede jeg dem på en rodet, manuel måde.

Jeg ville ønske, at jeg havde kendt til mdmerge, før jeg begyndte på det projekt. Det ville have sparet mig for en masse tid og energi.

mdmerge kombinerer, som du sikkert har gættet ud fra navnet, to eller flere Markdown-filer til en enkelt fil. Du behøver ikke at skrive navnene på filerne på kommandolinjen. I stedet kan du tilføje dem til en fil kaldet book.txt og bruge den som inddatafil for mdmerge.

Det er ikke alt, hvad mdmerge kan gøre. Du kan tilføje en henvisning til et andet dokument – enten et dokument, der er formateret med Markdown, eller et stykke kildekode – og trække det ind i dit hoveddokument. Det giver dig mulighed for at oprette masterdokumenter, som du kan skræddersy til bestemte målgrupper.

Mdmerge er ikke et af de værktøjer, som du vil bruge hele tiden. Når du får brug for det, vil du være glad for, at det ligger på din harddisk.

bashblog

bashblog er ikke udelukkende et værktøj til at arbejde med Markdown. Det tager filer, der er formateret med Markdown, og bruger dem til at opbygge en simpel blog eller et websted. Tænk på bashblog som en statisk webstedsgenerator, men en der ikke har en masse skrøbelige afhængigheder. Stort set alt, hvad du har brug for, er i et shellscript, der vejer lige under 50 KB.

For at bruge bashblog skal du blot have en Markdown-processor installeret på din computer. Derfra redigerer du shell-scriptet for at tilføje oplysninger om din blog – f.eks. dens titel, dit navn, dine links til sociale medier og lignende. Derefter kører du scriptet. Der åbnes et nyt indlæg i din standardteksteditor. Begynd at skrive.

Når du har gemt et indlæg, kan du udgive det eller gemme det som et udkast. Hvis du vælger at udgive indlægget, genererer bashblog din blog, indlæg og det hele, som et sæt HTML-filer, som du kan uploade til en webserver.

Out of the box er din blog intetsigende, men brugbar. Du kan redigere webstedets CSS-fil for at give det dit helt eget udseende.

Hvad med Pandoc?

Sikkert, Pandoc er et meget kraftfuldt værktøj til at konvertere filer formateret med Markdown til andre markup-sprog. Men der er mere at arbejde med Markdown på kommandolinjen end Pandoc.