Markdown

introductie

Joost van Meeteren


Markdown - Links

Wikipedia - Markdown.

Markdown Guide - the simple and easy-to-use markup language.


DILLINGER - The Last Markdown Editor, Ever.

README - ... voor het readme-bestand van uw project.


Markdown - Introductie

Markdown heeft tot doel een webpagina te creƫren zonder dat je over kennis van HTML beschikt.

Het idee is op zich sympathiek. Mijn vraag is echter of het coderen in Markdown echt zoveel eenvoudiger is als in HTML.
Je maakt met een platte tekst die je opmaakt in Markdown een tussenstap naar HTML.
Maar is het dan niet verstandiger om gelijk in HTML te leren coderen? Want je dient je als gebruiker de soms best wel complexe regels van Markdown eigen te maken.

En ook al zijn de (opmaak)regels in Markdown op zich beperkt, toch moet je ze wel leren gebruiken. De Markdown-code voor een afbeelding kan voor een leek een opgave zijn.

Vraag. En hoe bedreven ben jij om de HTML-code komend uit de Markdown-code te implementeren op de webserver?

Markdown voorziet immers niet in de webpagina als geheel. Het voorziet louter in het (op)maken van content (tekst en grafische elementen binnen het body-element).

Als je niet wilt coderen in Markdown of een Markup-taal als HTML, kun je overwegen te gaan werken in WordPress of Joomla. In deze CMS's kun je via een menu tekst en dergelijke opmaken zonder in aanraking te komen met HTML-code.

Preprocessor? Ik krijg de indruk dat Markdown een preprocessor is voor HTML door de vereenvoudigde codering zoals je die ook bij CSS-preprocessors ziet.
Op de vraag 'is markdown a preprocessor' in Google kwam het volgende antwoord: We offer four different HTML preprocessors that you can use while creating and editing Pens on CodePen: Markdown, Haml, Slim, and Pug. ....

Conclusie. Als je Markdown goed wilt gebruiken, dan moet je al met al een hele reeks codes leren om headings ( h1, h2 etc. ), opsommingen ( - - / * * en 1 2 ) en links ( [Markdown](https://nl.wikipedia.org/wiki/Markdown) ) te kunnen maken voor een webpagina.
De opmaak van tekst beperkt zich tot _cursief_ / *cursief*, __vet__, **vet**. Zeer beperkt dus.
Een horizontale lijn geef je aan met --- ( hr ).
En tot slot, in de HTML-codering hieronder in het voorbeeld staan 'classes' en andere attributen binnen de elementen h1 en p beschreven die niets toevoegen. Mijn voorbeeld 1c. zou al overzichtelijker zijn.


Markdown - Voorbeeld Markdown naar HTML


1a. Voorbeeld van Markdown:

### 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 formaten met een applicatie 
met dezelfde naam.[1] Markdown wordt vaak gebruikt voor de opmaak van projectdocumentatie 
(README-bestanden), eenvoudige CMS-systemen en berichten in online fora. Tekst in deze 
opmaaktaal is gemakkelijk te maken met een simpele teksteditor.

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

__Bron__: [Markdown](https://nl.wikipedia.org/wiki/Markdown) in Wikipedia.


1b. Corresponderend voorbeeld van Markdown in HTML:

<h3 class="code-line" data-line-start=0 data-line-end=1 ><a id="Markdown_0"></a>Markdown</h3>

<p class="has-line-data" data-line-start="2" data-line-end="3">Markdown is 
een lichtgewicht opmaaktaal op basis van platte tekst die zodanig ontworpen is dat 
het gemakkelijk valt te converteren naar HTML en andere formaten met een applicatie 
met dezelfde naam.[1] Markdown wordt vaak gebruikt voor de opmaak van projectdocumentatie 
(README-bestanden), eenvoudige CMS-systemen en berichten in online fora. Tekst in deze 
opmaaktaal is gemakkelijk te maken met een simpele teksteditor.</p>

<p class="has-line-data" data-line-start="4" data-line-end="5">Het ontwerpdoel 
van de taal is leesbaarheid. Teksten geschreven met behulp van Markdown worden geacht 
al leesbaar te zijn voordat opmaak is toegepast op de tekst. Opmaakinstructies en tags 
zijn dan ook niet te vinden in pure Markdown.</p>

<p class="has-line-data" data-line-start="6" data-line-end="7"><strong>Bron</strong>: <a 
href="https://nl.wikipedia.org/wiki/Markdown">Markdown</a> in Wikipedia.</p>

Gemaakt in DILLINGER.


1c. 'Opgeschoond' voorbeeld van Markdown in HTML:

<h3>Markdown</h3>

<p>Markdown is een lichtgewicht opmaaktaal op basis van platte tekst die 
zodanig ontworpen is dat het gemakkelijk valt te converteren naar HTML en andere 
formaten met een applicatie met dezelfde naam.[1] Markdown wordt vaak gebruikt 
voor de opmaak van projectdocumentatie (README-bestanden), eenvoudige CMS-systemen 
en berichten in online fora. Tekst in deze opmaaktaal is gemakkelijk te maken met 
een simpele teksteditor.</p>

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

<p><strong>Bron</strong>: <a href="https://nl.wikipedia.org/wiki/Markdown">Markdown</a> in Wikipedia.</p>


2a. Een foto in Markdown:

![Kleuren en bloei in eigen tuin op 17 juni 2024](https://lh3.googleusercontent.com/pw/AP1GczN0XPROzjb6n_nb2_0TE9otZZqjx2rsR4pQkW2RY5-
1uXtmznYrgHv-yOXAKWYnVAi3cYleYZG3Qet-GhB1Ge94CQZ1-2M69ZR4hRy8VNINIFfebVrTFHGGae4-g0HtS93fzFvEyARH0xHc9b-Qmyz62Q=w920-h920-s-no "Kleuren 
en bloei in eigen tuin op 17 juni 2024")
_Kleuren en bloei in eigen tuin op 17 juni 2024_

Gemaakt met Markdown Guide - Basic Syntax | Images.


2b. Het 'opgeschoonde' voorbeeld van de foto van Markdown in HTML:

<p><img src="https://lh3.googleusercontent.com/pw/AP1GczN0XPROzjb6n_nb2_0TE9otZZqjx2rsR4pQkW2RY5-
1uXtmznYrgHv-yOXAKWYnVAi3cYleYZG3Qet-GhB1Ge94CQZ1-2M69ZR4hRy8VNINIFfebVrTFHGGae4-g0HtS93fzFvEyARH0xHc9b-Qmyz62Q=w920-h920-s-no" 
alt="Kleuren en bloei in eigen tuin op 17 juni 2024" title="Kleuren en bloei in eigen tuin op 17 juni 2024"><br>
<em>Kleuren en bloei in eigen tuin op 17 juni 2024</em></p>


Markdown - Resultaten Markdown naar HTML

1. Tekst uit 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 formaten met een applicatie met dezelfde naam.[1] Markdown wordt vaak gebruikt voor de opmaak van projectdocumentatie (README-bestanden), eenvoudige CMS-systemen en berichten in online fora. Tekst in deze opmaaktaal is gemakkelijk te maken met een simpele teksteditor.

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

Bron: Markdown in Wikipedia.

2. Een foto uit Markdown

Kleuren en bloei in eigen tuin op 17 juni 2024
Kleuren en bloei in eigen tuin op 17 juni 2024


Joost De WebMaker
2002-2024 © Joost van Meeteren
Laatste update website: vrijdag 6 december 2024