Gå til hovedinnhold

Markdown format (.md, .markdown)

Markdown-formatet leser Markdown-dokumenter, trekker ut prosa som blokker, og skriver oversettelsene tilbake mens det bevarer dokumentets struktur: overskrifter, lister, uthevinger, lenker og kode. Inline- markering (fet, kursiv, lenker, inline-kode) eksponeres som inline-koder inne i hver blokk slik at den omkringliggende syntaksen overlever oversettelsen.

Som standard er avsnitt, overskrifter, listeelementer, blokksitering og bildetekst blokker, mens kodeblokker, YAML-frontmatter, rå HTML-blokker og lenke-/bilde-URLer behandles som ikke-oversettbar struktur. Hver av disse kategoriene kan slås av og på, og innebygd HTML kan rutes til et underfilter.

IDmarkdown
SourceBuilt-in
Extensions.md, .markdown
MIME Typestext/markdown, text/x-markdown
CapabilitiesRead + Write

How kapi reads it

Parameters

ParameterTypeDefaultDescription
codeFinderRulesarrayRegex-mønstre som samsvarer med innebygde koder i oversettbar tekst
extractNonTranslatableContentbooleantrueHvis sann (standard), vises ikke-oversettbart kontekstuelt innhold som kodeblokker som innholdsblokker (synlig for innlesing/LLM-konsumenter, hoppes over av maskinoversettelse) i stedet for å være skjult i skjelett. Deaktiver for å beholde det i skjelett.
frontMatterKeysarrayNøkler i frontmatter som skal trekkes ut når translateFrontMatter er på (tom = alle skalarverdier). Angi nøklene som inneholder prosa, f.eks. title og description.
subfilterstringUnderfilterformat som skal brukes på HTML-innhold i Markdown (f.eks. 'html')
translateBlockQuotesbooleantrueHvis sann, er blokksitatinnhold oversettbart.
translateCodeBlocksbooleanfalseHvis sann, er gjerdet og innrykket kodeblokker oversettbare. Hvis usann, sendes de ut som ikke-oversettbare data.
translateFrontMatterbooleanfalseHvis sann, er YAML front matter-verdier oversettbare. Hvis usann, sendes de ut som ikke-oversettbare data.
translateHTMLBlocksbooleanfalseHvis sann, er rå HTML-blokker oversettbare. Hvis usann, sendes de ut som ikke-oversettbare data.
translateImageAltbooleantrueHvis sann, inkluderes alt-tekst for bilder i det oversettbare innholdet.
translateURLsbooleanfalseHvis sann, er lenke- og bilde-URL-er oversettbare.
unescapeBackslashCharactersbooleanfalseAnalyser omvendt skråstrek-escaped tegnsetting i kildedokumenter
useCodeFinderbooleanfalseAktiver regex-basert deteksjon av innebygd kode i oversettbar tekst

Configure it live

Configuration
Loading form…

Examples

Oversett frontmater også

Inkluder YAML front matter-verdier sammen med prosaen.

translateFrontMatter: true

Håndter innebygd HTML strukturelt

Rut inline- og blokk-HTML gjennom HTML-underfilteret.

subfilter: html

Processing notes

  • Inline-merking (uthevelse, koblinger, inline-kode) blir inline-koder inne i blokker, slik at den overlever oversettelse uendret.

  • Strukturelle elementer (gjerder, listeindikatorer, overskriftprefikser) danner det ikke-oversettbare skjelettet.

Limitations

  • Kodeblokker, frontmater, rå HTML-blokker og URLer er ikke-oversettbare som standard; aktiver det tilsvarende alternativet for å trekke dem ut.

← Back to the Format Reference