Konverter og forhåndsvis Markdown

konverterer din Markdown til HTML og viser en live forhåndsvisning, ideel til at skrive README-filer, dokumentation eller artikler

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

MarkdownResultat
# Overskrift 1Overskrift <h1>
## Overskrift 2Overskrift <h2>
**fed**fed
*kursiv*kursiv
`inline-kode`inline-kode
```php ... ```PHP-kodeblok
[tekst](url)Hyperlink
![alt](url)Billede
- elementUordnet liste
1. elementOrdnet liste
> citatBlockquote
---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øjer
  • GET https://cdrn.fr/api/v1/tools/markdown-formatter - henter skemaet for dette værktøj
  • POST https://cdrn.fr/api/v1/tools/markdown-formatter/execute - udfører dette værktøj med et JSON-payload