Markdown

Markdown is een lichtgewicht opmaaktaal op basis van platte tekst die zodanig ontworpen is dat het gemakkelijk valt te converteren naar HTML en andere. Markdown wordt vaak gebruikt voor de opmaak van project documentatie (README-bestanden), eenvoudige CMS-systemen en berichten in online fora. Je kunt Markdown in iedere simpele teksteditor bewerken.

Het ontwerpdoel van de taal is leesbaarheid. Teksten geschreven met behulp van Markdown zijn al leesbaar voordat opmaak is toegepast op de tekst. Opmaakinstructies en tags zijn dan ook niet te vinden in pure Markdown.

De tekst in onze ReSpec documenten schrijven we in Markdown.

Markdown openen in je browser

Sommige browsers weigeren het openen van lokale bestanden, of negeren links naar locale bestanden. Dit kun je in de configuratie aanpassen:

Chrome

Je moet twee dingen instellen:

• Local access: Toestaan dat je local files toont in Chrome, dat is een opstart argument. Kan je doen vanuit een cmd-prompt `%localappdata%\google\chrome\application\chrome --allow-file-access-from-files
• CORS Toestaan : zelfde soort oplossing: --disable-web-security

Dit kan je ook in een snelkoppeling zetten als icoon op de desktop.

Firefox

In Firefox kan je dat instellen via de parameters.

• Ga naar het configuratiescherm van Firefox door about:config in de zoekbalk te zetten.
• Firefox vraag nu of je het zeker weet. Niet twijfelen.
• zet de instelling security.fileuri.strict_origin_policy = false op false.

Tools voor Markdown

tool	omschrijving
Markdown Tutorial	Handleiding Markdown
Markdown Reference	Naslag Markdown
Visual Studio Code	Fijne teksteditor die ook goed integreert met Github Desktop
PowerToys	Geeft preview van Markdown rechtstreeks in Windows Explorer (en nog heeel veel andere tooltjes)
Tables Generator	Helpt met het maken van tabellen in MarkDown
Markdown Table	VSCode plugin voor het editen van Markdown tabellen.
Prettier	Een code formatter die automatisch zorgt dat je markdown aan de regels voldoet.
markdownlint	Een style checker form markdown bestanden. Geeft meldingen voor verkeerde markdown
Live Server	VSCode plugin. Klik rechtsonder op "Go Live" en je ReSpec doc wordt in live browser geopend.

Markdown formattering

Voor beter leesbare en uitwisselbare Markdown spreken we volgende styling regels af:

• We maken gebruik van unix style line endings.

Tools zoals 'prettier' en 'markdownlint' helpen hierbij.

Configuratie bestanden hiervoor:

Voorbeeld van '.prettierrc':

{
    "tabWidth": 4,
    "useTabs": false,
    "singleQuote": true,
    "endOfLine": "lf",
    "proseWrap": "always",
    "printWidth": 80
}

Voorbeeld van .markdownlinkt.json:

{
    "default": true,
    "MD003": { "style": "atx" },
    "MD007": { "indent": 4 },
    "MD013": { "line_length": 80, "code_blocks": false, "heading_line_length": 200, "tables": false},
    "no-hard-tabs": false
}