Konverter og forhåndsvis Markdown
- Dashboard
- Dokumentation
- API
Hvad er Markdown?
Markdown er et letvægts-opmærkningssprog skabt af John Gruber i 2004. Det gør det muligt at skrive formateret tekst ved hjælp af en enkel og i rå form læsbar syntaks, som derefter konverteres til HTML.
Dette værktøj bruger specifikationen GFM (GitHub Flavored Markdown), den mest udbredte variant, som tilføjer understøttelse af tabeller, afkrydsningsfelter, kodeblokke med syntaksfremhævning og automatiske links.
Forhåndsvisningen til højre opdateres i realtid, mens du skriver. Knappen Send genererer den tilsvarende HTML-kode, som du kan kopiere eller downloade.
Grundlæggende Markdown-syntaks
| Markdown | Resultat |
|---|---|
# Overskrift 1 | Overskrift <h1> |
## Overskrift 2 | Overskrift <h2> |
**fed** | fed |
*kursiv* | kursiv |
`inline-kode` | inline-kode |
```php ... ``` | PHP-kodeblok |
[tekst](url) | Hyperlink |
 | Billede |
- element | Uordnet liste |
1. element | Ordnet liste |
> citat | Blockquote |
--- | Vandret skillelinje |
Almindelige anvendelsestilfælde
- GitHub README: skrivning af dokumentation til et open source-projekt.
- Teknisk dokumentation: skrivning af vejledninger, wikier eller dokumentationssider (MkDocs, Docusaurus, Hugo).
- Blogindlæg: de fleste CMS-systemer (Jekyll, Ghost, Contentful) accepterer Markdown.
- Kommentarer og issues: GitHub, GitLab, Jira, Notion og Slack understøtter alle GFM.
- Formaterede e-mails: konvertering af Markdown til HTML til integration i en HTML-e-mail.
- Noter og præsentationer: Obsidian, Notion, Marp og Reveal.js bruger Markdown.
Ofte stillede spørgsmål
Hvad er forskellen mellem standard Markdown og GFM?
Standard Markdown (CommonMark) dækker de grundlæggende elementer: overskrifter, lister, links, kode.
GFM (GitHub Flavored Markdown) tilføjer tabeller, opgavelister (- [ ] element),
indrammet kode med sprog (```php), omtaler og automatiske links.
Dette værktøj bruger GFM via biblioteket league/commonmark.
Er den genererede HTML sikker?
Ja. Konverteren er konfigureret til at fjerne rå HTML-tags (html_input: strip)
og blokere usikre links, hvilket forhindrer XSS-angreb.
Den producerede HTML er egnet til integration i en eksisterende webside.
Kan jeg inkludere HTML i min Markdown?
Af sikkerhedshensyn fjernes rå HTML indsat i Markdown ved konverteringen. Hvis du har brug for en brugerdefineret HTML-gengivelse, skal du skrive den ønskede HTML direkte.
Hvad er den maksimale dokumentstørrelse?
Der er ingen streng grænse på serversiden for dette værktøj. For meget lange dokumenter (mere end et par tusinde linjer) kan forhåndsvisningen i realtid blive langsommere afhængigt af din browser.
Anmodningseksempel
curl -X POST https://cdrn.fr/api/v1/tools/markdown-formatter/execute \
-H "Content-Type: application/json" \
-d '{"input":"..."}'
Inputskema
| Felt | Type | Påkrævet | Standard |
|---|---|---|---|
input |
text | – |
Endpoints
GET https://cdrn.fr/api/v1/tools- lister alle tilgængelige værktøjerGET https://cdrn.fr/api/v1/tools/markdown-formatter- henter skemaet for dette værktøjPOST https://cdrn.fr/api/v1/tools/markdown-formatter/execute- udfører dette værktøj med et JSON-payload