To jest wpis demonstracyjny — pokazuje wszystkie możliwości formatowania dostępne w tym systemie. Ustaw draft: true żeby nie był widoczny publicznie, draft: false żeby opublikować.


1. Frontmatter — pola SEO

Każdy wpis zaczyna się od bloku --- z metadanymi. Oto co obsługuje system:

PoleOpisWymagane
titleTytuł strony (tag <title> i OG)tak
descriptionMeta description i OG description (max ~155 znaków)tak
dateData publikacji (format YYYY-MM-DD)tak
modifiedData modyfikacji — aktualizuje article:modified_timenie
authorImię autoratak
categoryKategoria — musi być w słowniku CATEGORIEStak
tagsTablica tagów, np. ["bieganie", "trening"]tak
imageŚcieżka do zdjęcia hero (też OG image)nie
imageCaptionPodpis pod zdjęciem głównymnie
slugNiestandardowy URL, np. plan-10-tygodniowynie
draft: trueUkrywa wpis — nie pojawia się na liście ani w RSSnie

Canonical jest budowany automatycznie: https://www.runningsucks.pl/{slug}/

robots: noindex — jeśli potrzebujesz zablokować indeksowanie, używasz noindex: true w BaseLayout (nie w frontmatter — to wymaga zmiany w kodzie PostLayout).


2. Nagłówki

H1 — nie używaj w treści (jest już w <h1> generowanym z title)

H2 — główne sekcje artykułu

H3 — podsekcje

H4 — rzadko potrzebny


3. Tekst

Zwykły akapit. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Bieganie to sport dla każdego — nie wymaga specjalnych predyspozycji, tylko regularności.

Pogrubienie — ważne informacje.

Kursywa — akcent lub tytuł.

Pogrubiona kursywa — mocny akcent.

Przekreślenie — coś nieaktualnego.

kod inline — np. nazwa zmiennej lub komendy.


4. Listy

Lista nieuporządkowana

  • Buty do biegania
  • Skarpetki techniczne
  • Luźne spodenki
  • Opcjonalnie: zegarek GPS

Lista uporządkowana

  1. Rozgrzewka — 5 minut
  2. Bieg — zgodnie z planem
  3. Schłodzenie — 5 minut marszu
  4. Rozciąganie — 10 minut

Lista zagnieżdżona

  • Sprzęt podstawowy
    • Buty
    • Skarpetki
  • Sprzęt dodatkowy
    • Zegarek
    • Pas z bidonem

5. Cytat (blockquote)

Bieganie jest najprostszą formą ruchu — wystarczy wyjść za drzwi.

— Klasyk biegowy


6. Tabela

TydzieńTrening 1Trening 2Trening 3
12 min bieg / 4 min marsz × 5jak T1jak T1
23 min bieg / 3 min marsz × 5jak T1jak T1
35 min bieg / 2 min marsz × 4jak T1jak T1

7. Zdjęcia w treści

Zdjęcia wstawiasz składnią Markdown. Atrybut alt jest wymagany dla SEO i dostępności — opisuj co jest na zdjęciu, nie “zdjęcie przedstawia…”:

Biegacz na leśnej ścieżce podczas porannego treningu

Możesz też wstawić zdjęcie z podpisem owijając je w HTML (Markdown w .md obsługuje surowy HTML):

Para biegaczy na asfalcie — trening interwałowy w parku
Trening interwałowy — naprzemienne bieganie i marsz to fundament planu dla początkujących

Wskazówki dot. zdjęć:

  • Umieszczaj zdjęcia w public/images/
  • Używaj formatu .webp dla lepszej wydajności
  • loading="lazy" dla zdjęć poniżej fold, loading="eager" dla hero
  • Zalecany rozmiar hero: 1200×675 px (proporcja 16:9)

8. Separator poziomy

Trzy myślniki tworzą linię:


9. Kod blokowy

Trening tygodnia 1:
Poniedziałek: 5 × (2 min bieg + 4 min marsz)
Środa:        5 × (2 min bieg + 4 min marsz)
Piątek:       5 × (2 min bieg + 4 min marsz)

10. Linki

Link do strony zewnętrznej — zwykły link.

Plan 10 tygodniowy — link wewnętrzny.


Podsumowanie możliwości SEO

  • title → <title> + OG + Twitter
  • description → <meta name="description"> + OG + Twitter
  • canonical → <link rel="canonical"> (budowany automatycznie ze slug)
  • image → OG image + Twitter card image
  • date / modified → article:published_time / article:modified_time
  • alt na zdjęciach → wpisuj w składni ![alt tutaj](ścieżka.jpg)
  • draft: true → wyklucza z kolekcji, sitemap i RSS

Regularność i dobre ALTy to klucz do sukcesu w SEO.