Demo możliwości wpisu — formatowanie, zdjęcia i SEO
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:
| Pole | Opis | Wymagane |
|---|---|---|
title | Tytuł strony (tag <title> i OG) | tak |
description | Meta description i OG description (max ~155 znaków) | tak |
date | Data publikacji (format YYYY-MM-DD) | tak |
modified | Data modyfikacji — aktualizuje article:modified_time | nie |
author | Imię autora | tak |
category | Kategoria — musi być w słowniku CATEGORIES | tak |
tags | Tablica tagów, np. ["bieganie", "trening"] | tak |
image | Ścieżka do zdjęcia hero (też OG image) | nie |
imageCaption | Podpis pod zdjęciem głównym | nie |
slug | Niestandardowy URL, np. plan-10-tygodniowy | nie |
draft: true | Ukrywa wpis — nie pojawia się na liście ani w RSS | nie |
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
- Rozgrzewka — 5 minut
- Bieg — zgodnie z planem
- Schłodzenie — 5 minut marszu
- 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 1 | Trening 2 | Trening 3 |
|---|---|---|---|
| 1 | 2 min bieg / 4 min marsz × 5 | jak T1 | jak T1 |
| 2 | 3 min bieg / 3 min marsz × 5 | jak T1 | jak T1 |
| 3 | 5 min bieg / 2 min marsz × 4 | jak T1 | jak 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…”:

Możesz też wstawić zdjęcie z podpisem owijając je w HTML (Markdown w .md obsługuje surowy HTML):
Wskazówki dot. zdjęć:
- Umieszczaj zdjęcia w
public/images/ - Używaj formatu
.webpdla 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 zeslug) - image → OG image + Twitter card image
- date / modified →
article:published_time/article:modified_time - alt na zdjęciach → wpisuj w składni
 - draft: true → wyklucza z kolekcji, sitemap i RSS
Regularność i dobre ALTy to klucz do sukcesu w SEO.