PIM Fundamentals

Test Markdown Artikel Format

Et proof of concept for det nye markdown-baserede artikel format med inline JSON elementer

Udgivet 15. januar 2025
5 min læsning
Sivert Kjøller Bertelsen
PIM
Testing
Markdown

Introduktion til det Nye Format

Dette er en test artikel skrevet i Markdown i stedet for JSON. Målet er at gøre indholdsproduktion meget simplere og mere naturlig.

Med denne tilgang kan du skrive indhold ved hjælp af standard markdown formatering:

  • Fed og kursiv tekst
  • Lister (nummererede og unummererede)
  • Links som dette
  • Inline kode snippets
  • Og meget mere!

Hvorfor Markdown?

Markdown tilbyder flere fordele over ren JSON:

  1. Naturligt skriveflow - ingen grund til at escape anførselstegn eller bekymre sig om JSON syntaks
  2. Bedre versionskontrol - diffs er faktisk læsbare
  3. Editor support - syntaksfremhævning, stavekontrol, preview virker alle ud af boksen
  4. Hurtigere authoring - fokuser på indhold, ikke struktur
"Flytningen til markdown reducerede vores indholdsproduktion med 70% og gjorde det tilgængeligt for ikke-tekniske teammedlemmer"
SB
Jane Smith

Avancerede Elementer Stadig Tilgængelige

Selvom det meste indhold er almindelig markdown, kan vi stadig indlejre komplekse elementer ved hjælp af JSON kodeblokke. Dette giver os det bedste fra begge verdener.

Eksempel: Kodeblokke

Her er en almindelig markdown kodeblok:

const pim = new PIMClient({
  apiKey: 'your-api-key'
});

const products = await pim.getProducts();

Og her er et mere avanceret kode element med yderligere metadata:

javascript
const pim = new PIMClient();
await pim.enrichProduct(productId, {
  description: 'Enhanced product data'
});

Sammenligning med JSON Format

Den gamle måde krævede at skrive alt i JSON med escaped anførselstegn og omhyggelig syntaks. Det så sådan ud:

{
  "content": {
    "da": "Dette er en **test** med [links](https://example.com)"
  }
}

Den nye måde er bare naturlig markdown:

Dette er en test med links

Meget bedre!

Comparison table data is incomplete. Please check the content configuration.

Konklusion

Denne prototype demonstrerer at vi kan vedligeholde vores strukturerede indholdssystem samtidig med at vi dramatisk forbedrer authoring oplevelsen.

Parseren transformerer disse markdown filer til det eksisterende JSON schema ved build time, så der er ingen ændringer nødvendige til rendering komponenterne.

Næste Skridt

  1. Test parseren grundigt
  2. Konverter nogle rigtige artikler
  3. Indsaml feedback på formatet
  4. Iterer og forbedre

Klar til at gøre indholdsproduktion fantastisk igen!