Naar de inhoud

Markdown naar HTML-converter — Numio

Converteert Markdown naar HTML met de markdown-js bibliotheek, die de originele syntaxis van John Gruber volgt. Onbewerkte HTML in de broncode wordt als tekst geëscaped en GitHub-extensies zoals tabellen en afgeschermde codeblokken worden niet herkend.

Een README-sectie of release-opmerking plakken in een CMS-veld dat alleen HTML accepteert.

Markdown

HTML

Wanneer gebruik je dit?

  • Een README-sectie of release-opmerking plakken in een CMS-veld dat alleen HTML accepteert.
  • Controleren welke HTML-tags een stuk basis Markdown oplevert.

Hoe werkt het

  1. Plak Markdown in de linkereditor of laad een .md-bestand.
  2. Lees de gegenereerde HTML aan de rechterkant en bekijk het weergegeven voorbeeld eronder voor elke kop, lijst en link.
  3. Kopieer de HTML; het bevat alleen body-opmaak, dus voeg je eigen CSS toe waar je deze plakt.

Markdown

## Install

Run the **CLI** once:

    npm install -g douni

1. Open the [docs](https://douni.one)
2. Paste your file

| a | b |

HTML

<h2>Install</h2>

<p>Run the <strong>CLI</strong> once:</p>

<pre><code>npm install -g douni</code></pre>

<ol>
  <li>Open the <a href="https://douni.one">docs</a></li>
  <li>Paste your file</li>
</ol>

<p>| a | b |</p>

Details en beperkingen

De conversie wordt uitgevoerd in de browser. De uitvoer is een HTML-fragment zonder <html>, <head> of stylesheet; het voorbeeld geeft het weer in een sandboxframe met scripts uitgeschakeld.

Alleen originele Markdown wordt ondersteund. Pipe-tabellen, takenlijsten, ~~doorhalen~~ en ``` afgeschermde code blijven als tekst; gebruik inspringing met 4 spaties voor codeblokken.

Inline HTML zoals <div> wordt ge-escaped naar &lt;div&gt; en niet als HTML doorgegeven.

Afbeeldingen worden <img>-tags die naar de originele URL verwijzen; bestanden zijn niet ingesloten.

FAQ

Waarom worden mijn ``` codehekken niet omgezet in <pre>-blokken?

De bibliotheek dateert van vóór de omheinde code. Een hek wordt behandeld als inlinecode binnen een alinea. Laat de code vier spaties inspringen om <pre><code> te krijgen.

Ondersteunt het GitHub Flavored Markdown-tabellen?

Nee. Een regel als | een | b | wordt uitgevoerd als een gewone alinea.

Kan ik onbewerkte HTML in mijn Markdown behouden?

Nee. HTML-tags worden van escapetekens voorzien en in het resultaat als tekst weergegeven, dus een ingesloten <div> wordt niet als element weergegeven.

Specificaties en referenties