Julkaistu 30. kesäkuuta 2026 Päivitetty 1. heinäkuuta 2026

Esimerkki blogikirjoituksen ominaisuuksista

Tiivis Markdown-esimerkki blogin metatiedoista, kuvista, listoista, lainauksista, taulukoista, koodista ja tarkistuslistoista.

EsimerkkiMarkdownAstroSisältö

Tämä on sivuston yksittäinen julkaistu esimerkkikirjoitus. Se ei ole kaikkien kirjoitusten pohja, vaan tiivis referenssi siitä, mitä blogikirjoitus voi sisältää, kun oikea artikkeli tarvitsee enemmän kuin tavallisia tekstikappaleita.

Personal Website -projektin esikatselukuva esimerkkikirjoituksen kuvana

Pikakatsaus

Kirjoitus voi yhdistää vahvaa korostusta, kevyttä korostusta, sisäisiä linkkejä ja rivinsisäistä koodia, kuten getCollection("blog"), ilman erillisiä komponentteja.

  • Frontmatter määrittää kielen, käännösavaimen, URL-polun, otsikon, kuvauksen, julkaisu- ja päivityspäivän, tagit, luonnostilan ja esikatselukuvan.
  • Markdown hoitaa otsikot, kuvat, listat, taulukot, lainaukset ja koodilohkot.
  • Blogiarkisto, kirjoitussivut, RSS-syöte, sivukartta ja artikkelimetatiedot syntyvät samasta sisältömerkinnästä.

Tarkistuslista

  • Näytä metatiedot sivun yläosassa ja strukturoidussa datassa.
  • Renderöi leveä kuva artikkelin sisällä.
  • Pidä koodiesimerkit luettavina kapeilla näytöillä.
  • Korvaa esimerkki oikealla kirjoituksella, kun blogi on valmis.

Lyhyt työnkulku

  1. Kirjoita yksi Markdown-tiedosto jokaista kieltä varten.
  2. Anna käännetyille tiedostoille sama translationKey.
  3. Käytä kielikohtaista slug-, title-, description- ja tags-metatietoa.
  4. Aja build, jotta Astro validoi sisältökokoelman.

Hyvä esimerkki on tarpeeksi konkreettinen testaamaan taittoa, mutta tarpeeksi pieni, jotta oikea sisältö voi korvata sen ilman erillistä siivousprojektia.

Koodiesimerkki

const postFeatures = {
  metadata: ["lang", "translationKey", "slug", "title", "description", "pubDate", "updatedDate", "tags", "heroImage"],
  markdown: ["images", "lists", "tables", "quotes", "code"],
  output: ["static page", "RSS item", "sitemap URL", "article schema"],
};

export const isShowcaseReady = postFeatures.markdown.includes("tables");

Vertailutaulukko

OminaisuusMistä se tuleeMihin sitä käytetään
translationKeyJaettu frontmatterRyhmittelee englannin- ja suomenkielisen version yhteen
slugKielikohtainen frontmatterLuo julkisen URL-polun kyseiselle kielelle
TagitFrontmatter-taulukkoAihemerkinnät korteissa ja kirjoitussivuilla
KoodilohkotMarkdown-sisältöTekniset esimerkit vaakavierityksellä

Toinen kuva

Toinen projektikuva osoittamassa, että kirjoituksessa voi olla useampi kuva

Viimeinen kappale pitää esimerkin tiiviinä ja varmistaa samalla, että tavallinen teksti jatkuu siististi rikkaampien lohkojen jälkeen.