De standaard Markdown
Markdown is een standaard ontwikkeld door John Gruber. Het belangrijkste doel van Markdown is om het bestand zelfs in pure tekst leesbaar te maken. Als u in een teksteditor wilt kijken, moet u deze gemakkelijk kunnen lezen. Dit is erg handig voor gebruikers van vim en dergelijke. Let op, en onthoud dat dit een standaard is voor het wijzigen van tekstbestanden. Het vervangt geen HTML. In plaats daarvan gebruik je het om HTML te maken waar het handig is. In het geval van GitHub formatteren ze het Readme-bestand op de site. Zolang je de standaard volgt, kun je er zeker van zijn dat het er goed uitziet.
Aangezien GitHub slechts een paar extensies heeft toegevoegd, moet je beginnen met het gebruik van een Markdown-cheatsheet en van daaruit verder gaan. Hier is een lijst met de meest voorkomende.
Markdown | Extensies | Resultaat |
# (1 per niveau) | Koppen | |
* | Cursief | |
** | Stoutmoedig | |
> | Blokcitaat | |
1. (enz.) | Bestelde lijst | |
- | Ongeordende lijst | |
'code' | Jouw code | |
"' | Md-ext | Een codeblok starten en beëindigen |
- | Horizontale regel | |
[Beschrijving](https://www.voorbeeld.com) | Een naam in het vierkant en URL tussen gewone haakjes | |
![alt-tekst](afbeelding.png) | Idem, link naar een afbeelding | |
[1] | Md-ext | een voetnoot |
De lijsten kunnen worden genest door items in te laten springen die u genest wilt hebben.
Andere extensies voor reguliere Markdown, je hebt de bovenstaande codeblokextensies. Ze worden niet altijd ondersteund door services.
Markdown | Extensies | Resultaat |
### Kop #custom-id | Md-ext | Een kop die u kunt adresseren met zijn ID |
term: definitie | Md-ext | Een lijst met termen met definities |
~ Verkeerde tekst ~ | Md-ext | Doorgestreepte tekst |
- [x] Taak om te doen | Md-ext | Een takenlijst die je kunt afvinken |
De tabel is heel eenvoudig, maar je hebt meerdere rijen nodig om hem te tonen: Tabel:
| Naam | WAARDE|| ----------- | ---------- |
| Matten | 100 |
GitHub-extensies.
GitHub heeft een paar extensies toegevoegd om het eenvoudiger te maken om links naar andere mensen en projecten te verwerken. Sommige daarvan zijn de eerder genoemde tabellen. Degene die u het meest zal helpen, is de extensie voor automatisch koppelen. Het maakt zelf een link wanneer je het op GitHub gebruikt.
Anderen zijn tabellen en takenlijstitems. Deze zijn handig om uw taken in projecten bij te houden. De laatste om te vermelden is de Disallowed Raw HTML-extensie. Met behulp van deze extensie worden sommige tags gefilterd bij het renderen voor HTML. Deze tags kunnen vreemde effecten veroorzaken bij het renderen naar GitHub.
Manieren om GitHub Markdown te verkennen
Als je het verwarrend vindt, kun je ook naar de GitHub-pagina gaan en de ingebouwde editor gebruiken. Als je het gebruikt, worden sommige functies automatisch voltooid. Dit werkt alleen voor problemen, maar je kunt het gebruiken om sommige dingen uit te zoeken, de emoji's verschijnen als een lijst wanneer je een dubbele punt typt (:).
Je kunt ook een project op GitHub vinden met een fantastisch README-bestand en het naar je lokale schijf klonen. Van daaruit kunt u het bestand verkennen met elke gewenste editor. Voor de grote redacteuren, Emacs en Vim, is er ondersteuning voor markdown via extensies.
Als u vim gebruikt, kunt u een extensie voor syntaxisaccentuering van GitHub, vim-markdown. Deze extensie laat zien dat je de code correct hebt uitgevoerd. Om u te helpen zien hoe het eruit ziet als u klaar bent, kunt u ook de live-markeringsextensie krijgen. Hiermee kunt u een webserver laten draaien die het resultaat live laat zien terwijl u typt.
Met Emacs heb je ongeduldige modus, live down-modus en Realtime-preview. Ze tonen allemaal uw resulterende pagina in een browser terwijl u typt. De eerste vereist minder bibliotheken dan de laatste, maar heeft een extra codefragment nodig om uit te voeren.
Conclusie
Hoewel afwaardering een kleine en opzettelijk eenvoudige specificatie is, kan het een beetje verwarrend zijn om mee te beginnen. De beste manier om te leren is om een spiekbriefje te gebruiken en je Markdown-document te schrijven. U kunt uw README updaten.md op GitHub, en je kunt veel ondersteuning krijgen van de ingebouwde functies van je editors. Als een kanttekening ondersteunt GitHub ook emoji's die je aan je document kunt toevoegen. Je kunt het spiekbriefje gebruiken om te zien welke dat zijn.
Download Markdown-CheatSheetHier