Lightweight Markup Languages: Detta är varför du bör använda AsciiDoc över Regular Markdown

Markdown-språk kommer i många smaker, av vilka några är bättre än andra. Lättviktiga språk som AsciiDoc är lätta att lära och mycket användbara. Så här jämför den.

Markdown-språk kommer i många smaker, av vilka några är bättre än andra.  Lättviktiga språk som AsciiDoc är lätta att lära och mycket användbara.  Så här jämför den.
Annons

Som du troligen har sett från tidigare artiklar, här på MakeUseOf, är vi fans av Markdown What Is Markdown? 4 skäl till att du borde lära dig nu Vad är Markdown? 4 Anledningar till varför du borde lära dig nu Trött på HTML och WYSIWYG redaktörer? Då är Markdown svaret för dig, oavsett vem du är. Läs mer . Genom att lära sig det här enkla och intuitiva formatet kan du enkelt skapa snygg utskrift. Från PDF till webbsidor blir din ödmjuka, vanliga textfil ett sofistikerat dokument.

Men Markdown är inte det enda spelet i stan. Det finns ett antal andra så kallade lätta markup språk som liknar Markdown men med olika funktionssätt. En av dessa är Asciidoc. Om du gillar Markdown men letar efter lite mer under huven, är det värt att överväga. Här är några anledningar till varför.

Vad är ett "Markup Language" Hur som helst?

Ett uppmärkningsspråk är en uppsättning koder som, när de tillämpas på annars vanlig text, låter dig lägga till en eller flera av följande egenskaper (bland annat):

  • Definiera texten
  • Strukturera texten
  • Beskriv textens layout
  • Dekorera texten

Ett spårningsspråk du möter varje dag (om du inte är en eremit) är Hypertext Markup Language, eller HTML. De webbplatser och applikationer som ger dig nyheter och visar dig din e-post är byggda, åtminstone delvis med HTML-markup. Lär dig HTML och CSS med dessa steg för steg-handledning. Lär dig HTML och CSS med dessa steg för steg-handledning. Nyfiken om HTML, CSS, och JavaScript? Om du tycker att du har en förmåga att lära dig hur du skapar webbplatser från början - här är några bra steg-för-steg-tutorials värda att försöka. Läs mer . HTML använder sig av taggar som mekanism för att markera rå textinnehåll. Tänk på följande HTML-kod:

Presentera HTML

Här är en paragraf i HTML ... vi vet att det är en paragraf eftersom de omgivande \ -taggen definierar den som en.

Här, den

tagg anger att all text som ska följas fram till dess stängning

tagg, är en punkt. I den meningen definieras texten som en punkt.

Men notera också taggarna ... Dessa tjänar ofta för att definiera layouten på en webbsida, till exempel hur mycket marginal det finns på sidan av skärmen.

Och taggarna kommer att dekorera ordet "stycke" i fetstil, medan

taggar kan både lägga ut rubriken (avstånd från omgivande text) samt definiera en större typsnitt.

Problemet med vissa markup språk (HTML bland dem) är att det är en väldigt tråkig affär att skriva dessa taggar manuellt. Och med andra språk som XML Vad är en XML-fil och vad är dess användningsområden? [Om du undrade] Vad är en XML-fil och vad är dess användning? [Om du undrade] Läs mer, taggarna och deras attribut utgör en större del av det övergripande innehållet än själva texten! Ta en titt på följande DocBook-kod, en XML-dialekt som används för att skapa många tekniska publikationer:

asciidoc markdown docbook taggar

All text i lila representerar taggar som du själv behöver skriva in. Den första stycket börjar inte till längst ner på den bilden. Och om det inte är rätt exakt enligt DocBook-standarden kan du inte konvertera det till det vackra PDF-dokumentet som vanligtvis är slutmålet.

Ange Lightweight Markup Language

Om du vill utnyttja markeringsspråk, till exempel genom att publicera en HTML-sida på webben eller konvertera en DocBook-fil till PDF så att den kan skrivas ut behövde du göra en av två saker. Å ena sidan kan du investera tid genom att lära dessa språk inifrån och ut, skriva dem manuellt och sedan trippelkontrollera ditt arbete. Eller du kan investera pengar i ett verktyg som hanterar komplexiteten hos dessa för dig.

Lyckligtvis kom några innovativa utvecklare fram med ett tredje alternativ. De skapade nya markup språk som innehöll många (i vissa fall mest eller alla) av funktionerna i de tyngre motsvarigheterna, men förenklade syntaxen mycket. Dessa "lätta" språk inkluderar den välbekanta Markdown What Is Markdown? 4 skäl till att du borde lära dig nu Vad är Markdown? 4 Anledningar till varför du borde lära dig nu Trött på HTML och WYSIWYG redaktörer? Då är Markdown svaret för dig, oavsett vem du är. Läs mer såväl som Asciidoc, Emacs Org-Mode-format och Mediawiki-syntaxen.

Lättviktiga märkningsspråk Har enkel syntax

Ett kännetecken för dessa språk är att deras "taggar" (som de är) borde vara intuitiva. Låt oss ta en titt på det tidigare stycket, den här gången skrivet i Asciidoc:

 Introducing Asciidoc -------------------- Where are the *paragraph* tags? We dont need them... Asciidoc is smart enough to realize this is a paragraph! 

Mycket mer läsbar, nej? Från början kan vi identifiera rubriken som den är "understruken" med bindestreck. Du kan göra det här om du var handstil, dra bara en underrubrik under rubriken på sidan i din anteckningsbok. Det finns inga stycke-taggar - Asciidoc anser något mellan två tomma linjer som inte har någon annan markering på den för att vara "vanlig" stycktext. Slutligen indikerar asteriskerna runt ordet "stycke" fetstil. Höj din hand om du har gjort det i ett textmeddelande för att betyda exakt samma sak.

Var och en har en eller flera korresponderande processorer

"Tungviktiga" uppmärksalspråk har vanligtvis en dedikerad applikation för att tolka dem för dig. På webben är det din webbläsare samt eventuellt webbservern som kommer att göra koden till flashiga webbsidor Allt du behöver veta om Content Management Systems Allt du behöver veta om Content Management Systems För den genomsnittliga internet surferen, tittar innehållet är lätt. Du öppnar en länk, och sidan visas. Men vad sker bakom kulisserna? Så här ser dina favorit CMS-företag på sig. Läs mer . För dokument i XML kan det vara något som Microsoft Word, som läser och skriver det är DOCX-format Så här öppnar du Microsoft Word 2007 DOCX-filer Så här öppnar du Microsoft Word 2007 DOCX-filer Har du någonsin fått en av dessa filer med .docx-tillägget och undrade vad man skulle göra med det? Det kan inte ses i äldre Word-versioner, så hur kan du öppna en. Docx-fil ... Läs mer (vilket är en annan XML-dialekt). Så du behöver aldrig interagera direkt med källan till dessa dokument, bara de vackra fasaderna som dina appar visar dig.

Samtidigt är dokument skrivna på lättviktiga språk läsbar i källform (annan hyresgäst), men bara sanna nördar kan tycka att de är vackra. För att få rätt utgång måste du använda en processor . Det här är applikationer som kommer att köras genom din markup-linje för rad och konvertera den till något annat som ser bra ut. Samma projekt som utvecklar språket i sig kommer vanligtvis att skapa ett verktyg för att gå med det. Markdown-projektet erbjuder ett Perl-skript med samma namn, och Asciidoc sällskapsprogram är skrivet i Python. Dessutom kommer andra konverteringsverktyg att inkludera stöd för några av dessa språk. En sådan är den utmärkta Pandoc Så här enkelt konverterar du mellan dokumentformat i Linux Hur du enkelt kan konvertera mellan dokumentformat i Linux Att byta till Linux kan leda till problem med filkompatibilitet. Dokument ser inte likadana ut i LibreOffice som de gör i Word. Detta är bara en anledning till varför du behöver pandoc. Läs mer, vilket kommer att ta Markdown samt lätta markeringar reStructured Text, Mediawiki och Org-Mode och konvertera dem till PDF, DOCX, ODT och mer.

asciidoc markdown pandoc format

Resultatet är att lätta markeringsspråk gör att du kan arbeta i vanlig text, det mest bärbara datformatet på planeten, men producerar fortfarande snygg utskrift i slutet. Nu när du är övertygad om dess fördelar, vilket språk ska du välja? Markdown är utan tvekan den mest populära, och har dess fördelar (mer om dessa senare). Men speciellt Asciidoc är ett värdigt alternativ. I nästa avsnitt utforskar vi några orsaker till varför.

Jämförelse av Markdown och Asciidoc

Asciidoc-formatet skapades för att få lättare enkelhet i DocBook, ett av de vanligaste formaten i långformat (särskilt tekniskt) skrivande. En av dess påståenden om berömmelse är att det är en en-till-en-översättning, vilket betyder för varje element i DocBook, det finns en motsvarande representation i Asciidoc. Nedan tar vi en titt på några av fördelarna och nackdelarna med Asciidoc jämfört med Markdown.

Asciidoc täcker en uppsättning skrivningselement

Markdowns mål från början var att vara ett enkelt format för webbförfattare. Som sådan är de skrivelement som den stöder (åtminstone den ursprungliga implementeringen, se nedan) fokuserade kring att automatisera de mer tidskrävande aspekterna av att skriva HTML (listor till exempel som kräver

    eller
      taggar utöver
    • taggar för varje objekt).

      asciidoc markdown komplexa format

      Asciidoc innehåller också dessa, men erbjuder även mer avancerade DocBook-element som tillskott (t.ex. "Obs:" eller "Info:" callout-block) och komplexa tabelllayouter. Det betyder inte att du behöver använda dem hela tiden, men de kommer att vara där och tillgängliga om du någonsin behöver dem.

      Asciidoc är ett enhetligt format

      När populariteten av Markdown började ta av, började några av sina användare att lösa några av de brister som diskuterats ovan. Så dessa användare började utveckla sina egna tillägg för att lösa dessa problem, till exempel möjligheten att lägga till tabeller eller fot / slutnoter. Snart fanns det många "smaker" av Markdown, inklusive (bland annat):

      • Smaken som används av Github för "Readme" -filerna av projekt som det värd.
      • En "förlängd" smak som är född ur en PHP-port i den ursprungliga Markdown med extra HTML-relaterade funktioner.
      • En smak som heter "MultiMarkdown" som implementerade många funktioner i längre formskrivning, inklusive citat, definitioner och korsreferenser.

      Resultatet är att ditt dokument kanske kräver element som inte alla är täckta av en enda smak. Däremot lider Asciidoc inte av samma fragmentering som Markdown gör för närvarande.

      Asciidoc riktar sig till en mängd olika publiceringsstilar

      Markdown är utmärkt för att snabbt få ett blogginlägg ur ditt huvud och på sidan. Men ur lådan är det inte byggt för att strukturera längre arbeten, som en bok. Asciidoc är utformat för detta, och ett exempel är dess "inkludera" funktioner. Dessa uttalanden låter dig inkludera allt innehåll i en fil i en annan:

       include::somefile.adoc 

      Detta är inte till skillnad från hur masterdokument fungerar i ordbehandlare. Detta låter dig till exempel utarbeta varje kapitel som en separat fil, och "inkludera" dem alla i en fil som representerar boken. När du behandlar den "bokfilen" kommer utmatningen att vara som om alla kapitel skrevs direkt i det dokumentet.

      Markdown är tillräckligt för de flesta användare

      Markdown täcker alla baser för en större del av användarna. För dem som bara tittar på bloggen, eller skriver upp några anteckningar i ett vanligt textformat, stöder Markdown alla de element de behöver. Korsreferenser betyder inte mycket för en användare som bara vill skapa ett enkelt memo eller en webbsida. Du kan till och med använda Markdown för längre arbeten med enkla layouter, till exempel en roman som behöver Scrivener? 5 nya skrivprogram för Linux som behöver Scrivener? 5 Novel Skriva Apps för Linux Scrivener är inte tillgänglig för Linux - så hur kommer du att hålla reda på var dessa karaktärer går, vad de har gjort och hur de färdigställer sin resa? Tja, ett av dessa verktyg borde hjälpa. Läs mer, och kombinera dem själv i slutet.

      Markdown är bättre stödd

      Eftersom Markdown möter behoven hos ett större användargränssnitt, har det bättre stött på följande:

      • WYSIWYG redaktörer (som definieras av dem som åtminstone ger en live förhandsgranskning) är mycket mer benägna att stödja Markdown.
      • Online-tjänster, såsom den förutnämnda Github, är mer benägna att acceptera Markdown direkt eller genom användning av tillägg 6 Markdown Editors som spelar trevligt med Google Drive 6 Markdown Editors som spelar trevligt med Google Drive Markdown är textredigeringsformatet för framtiden. Det är enklare, snyggare och lättare att använda än HTML utan att offra mycket makt eller flexibilitet. Läs mer .
      • Även om publiceringssystem som statiska webbplatsgeneratorer 7 skäl att ditch ditt CMS och överväga en statisk webbplatsgenerator 7 skäl att ditch ditt CMS och överväga en statisk webbplatsgenerator Under många år var det svårt för många användare att publicera en webbplats. CMS som WordPress ändrade det, men de kan fortfarande vara förvirrande. Ett annat alternativ är en statisk webbplatsgenerator. Läs Ofta support Asciidoc med plugins, att de stöder Markdown ut ur lådan är nästan en given.

      Är du villig att ge Asciidoc ett försök?

      Medan Markdown är något av ett faktiskt val bland lätta markup-språk innehåller Asciidoc alla samma element och sedan några. Extras av Asciidoc kräver lite tid att lära sig, genom att bättre förbereda dig för större och mer komplexa skrivprojekt.

      Vad tror du? Är du nöjd med Markdowns enkelhet? Eller skapar du ditt eget flerkanalspublicerings arbetsflöde med Asciidoc lockande? Kanske hatar du vanlig text och det är Word hela vägen för dig? Låt oss veta i kommentarerna nedan!

In this article