Phenquestions
Standard Markdown
Markdown är en standard utvecklad av John Gruber. Huvudmålet med Markdown är att göra filen möjlig att läsa även i ren text. Om du vill titta i en textredigerare bör du ha en lätt tid att läsa den. Detta är mycket användbart för användare av vim och liknande. Observera och kom ihåg att detta är en standard för att ändra textfiler. Det ersätter inte HTML. Istället använder du den för att skapa HTML där det är användbart. I fallet med GitHub kommer de att formatera Readme-filen på webbplatsen. Så länge du följer standarden kan du känna dig säker på att den kommer att se bra ut.
Eftersom GitHub har lagt till några få tillägg bör du börja med ett Markdown-cheatsheet och gå därifrån. Här är en lista över de vanligaste.
| Prissänkning | Tillägg | Resultat |
| # (1 per nivå) | Rubriker | |
| * | Kursiv | |
| ** | Djärv | |
| > | Block citat | |
| 1. (etc.) | Beställd lista | |
| - | Oordnad lista | |
| 'koda' | Din kod | |
| “' | Md-ext | Starta och avsluta ett kodblock |
| - | Horisontell regel | |
| [Beskrivning] (https: // www.exempel.com) | Ett namn i kvadrat och URL i vanliga parenteser | |
| ![alt text] (bild.png) | Samma, länk till en bild | |
| [1] | Md-ext | En fotnot |
Listorna kan kapslas genom indragning av alla objekt du vill ha kapslade.
Andra tillägg till vanlig Markdown, du har koden blockerar tillägg ovan. De stöds inte alltid av tjänster.
| Prissänkning | Tillägg | Resultat |
| ### Rubrik # anpassad-id | Md-ext | En rubrik som du kan adressera med dess ID |
| term: definition | Md-ext | En lista med termer med definitioner |
| ~ Felaktig text ~ | Md-ext | Genomträngande text |
| - [x] Uppgift att göra | Md-ext | En uppgiftslista som du kan kryssa för |
Tabellen är mycket enkel, men du behöver flera rader för att visa den: Tabell:
| Namn | VÄRDE || ----------- | ---------- |
| Mattor | 100 |
GitHub-tillägg.
GitHub har lagt till några tillägg för att göra det enklare att hantera länkar till andra människor och projekt. Några av dessa är de tabeller som nämnts tidigare. Den som hjälper dig mest är tillägget auto-länk. Det skapar en länk på egen hand när du använder den på GitHub.
Andra är tabeller och uppgifter i uppgiftslistan. Dessa är praktiska för att hålla reda på dina uppgifter i projekt. Den sista att nämna är tillåtet rå HTML-tillägg. Med hjälp av detta tillägg filtreras vissa taggar vid rendering för HTML. Dessa taggar kan orsaka konstiga effekter vid rendering till GitHub.
Sätt att utforska GitHub Markdown
Om du tycker att det är förvirrande kan du också gå till GitHub-sidan och använda den inbyggda redigeraren. När du använder den kommer den att slutföra vissa funktioner automatiskt. Detta fungerar bara för problem, men du kan använda det för att räkna ut några saker, emojis kommer ut som en lista när du skriver ett kolon (:).
Du kan också hitta ett projekt på GitHub som har en snygg README-fil och klona den till din lokala enhet. Därifrån kan du utforska filen med vilken redigerare du vill. För de stora redaktörerna, Emacs och Vim, finns det stöd för markdown genom tillägg.
Om du använder vim kan du lägga till en syntax markeringstillägg från GitHub, vim-markdown. Det här tillägget visar att du har gjort koden korrekt. För att hjälpa dig att se hur det ser ut när du är klar kan du också få förlängningen live-märke. Med detta kan du köra en webbserver som visar resultatet live medan du skriver.
Med Emacs har du otåligt läge, live down-läge och förhandsgranskning i realtid. De visar alla din resulterande sida i en webbläsare medan du skriver. Det första kräver mindre bibliotek än det senare men behöver ett extra kodavsnitt för att kunna köras.
Slutsats
Även om markdown är en liten och medvetet enkel specifikation, kan det vara lite förvirrande att komma igång med. Det bästa sättet att lära sig är att använda ett fuskark och skriva ditt Markdown-dokument. Du kan uppdatera din README.md på GitHub, och du kan få mycket stöd från dina redaktörers inbyggda funktioner. Som en sidoanteckning stöder GitHub också emojis som du kan lägga till i ditt dokument. Du kan använda fuskarket för att hitta vilka de är.
Ladda ner Markdown-CheatSheet här
