Wszystko naraz

§1.1Znaki w tekście

Parser wyróżnień jest przyjazny CJK: pogrubienie domyka się nawet o chińską interpunkcję — **报文。**同时 renderuje się jako 报文。同时, a nie jako dosłowne gwiazdki. Kursywa, przekreślenie i kod w linii działają jak zwykle; z włączonym przełącznikiem gemoji skrót taki jak :sparkles: renderuje się jako ✨. Znaki wewnątrz kodu w linii nie biorą udziału w żadnym parsowaniu, więc grawisy to bezpieczny sposób, by składnię pokazać: **, $…$ i > [!note] pojawiają się dosłownie. Żeby pokazać gwiazdkę w tekście, poprzedź ją ukośnikiem — *o tak* zostaje zwykłym tekstem.

§1.2Wikilinki

Z włączonym przełącznikiem wikilinks linki [[w podwójnych nawiasach]] rozwiązują się względem kolekcji notatek tak, jak oczekuje tego wiki: po id (design-tokens — z polskiej strony lustrzanej link trafia najpierw do lustrzanej wersji w tym samym języku, a dopiero gdy jej brak, do angielskiego oryginału), po aliasie (boundaries dociera do notatki o id three-way-split) i z etykietą (przewodnik pierwszych kroków). Cel, który nie rozwiązuje się do niczego, renderuje się jako oznaczony martwy link zamiast wywracać build — a CLI silnika check-wikilinks raportuje go w CI, czyli tam, gdzie gnicie linków należy.

§1.3Tabele: przewijanie na szeroko, karty na wąsko

Tabela o sześciu lub więcej kolumnach powinna w wąskim kontenerze przełamać się na jedną kartę na wiersz, zamiast ściskać każdą komórkę do dwóch znaków. Ta siedmiokolumnowa tabela jest zarazem ściągą wariantów calloutów i żywym testem tego przełamania (zwęź okno do szerokości telefonu):

Domyślne tytuły są angielskie; witryna podmienia cały zestaw opcją calloutLabels presetu siteMarkdown, np. calloutLabels: { tip: 'Intuicja' }. Tytuł zapisany w składni cytatu (> [!tip] Mój tytuł) zawsze wygrywa.

§2.1Callouty: trzy pisownie

Najpierw składnia cytatu znana z Obsidiana/GitHuba (dostępna przy callouts: true, działa też w zwykłych plikach Markdowna):

Znacznik zwijania z Obsidiana jest honorowany — > [!note]- renderuje się zwinięty, > [!note]+ otwarty:

Po drugie, komponent pakietu w MDX (astro-inkstone/components/Callout.astro, importowany po ścieżce). Bez title pokazuje domyślną etykietę wariantu — tę samą, której używa składnia cytatu:

Po trzecie, surowy HTML, wszystkie sześć wariantów za jednym zamachem (jeden do jednego z regułami .callout w base.css):

§2.2Matematyka

Wzory w linii siedzą w tekście: głębokość optyczna zapisuje się $\tau = \int \kappa \rho \, \mathrm{d}s$. Matematyka wystawowa przyjmuje formę trzyliniową ($$ w osobnych liniach) — strażnik odrzuca formę jednoliniową, która po cichu wyrenderowałaby się jako mały wzór w linii:

Podłoże wzoru jest celowo innym papierem niż podłoże tekstu i przełącza się razem z motywem. Przy okazji: ceny w dolarach w tekście poprzedzaj ukośnikiem — ta kawa kosztuje $3.

§3.1Ramki kodu

Blok z title="…" dostaje pasek tytułu z nazwą pliku; przycisk kopiowania w rogu działa w całej witrynie. Adnotacje liniowe [!code ++] / [!code --] renderują się jako podłoża diffu:

def build_pipeline(opts):
    plugins = [remark_math]  
    plugins = [remark_gemoji, remark_math]  
    return assemble(plugins, guard=opts.guard)

Ramka oznaczona collapse startuje zwinięta i zajmuje miejsce dopiero po otwarciu — w sam raz dla długich plików konfiguracji:

site:
  markdown:
    numbering: chapters
    math: true
    codeFrame: true
    mermaid: true
    callouts: true
    wikilinks: true
  styles:
    - astro-inkstone/styles/tokens.css
    - astro-inkstone/styles/base.css

Podwójne motywy podświetlania bierze się stąd, że shiki emituje oba zestawy kolorów naraz; base.css wybiera jeden po data-theme w jednym miejscu — bez przeciągania liny na specyficzność.

§3.2Diagramy Mermaid

Blok ```mermaid zostawia w czasie budowania tylko miejsce na diagram; renderer ładuje się dynamicznie wyłącznie na stronach, które diagram niosą (strony bez diagramu nie płacą nic), i renderuje od nowa, gdy motyw się przełącza:

flowchart LR
  A["astro-inkbrush<br/>silnik: edycja / dialekt / strażnik"] --> C["twoja witryna<br/>tożsamość / routing / wdrożenie"]
  B["astro-inkstone<br/>papier: tokeny / style / potok"] --> C
  A -. jeden wspólny dialekt .-> B

§3.3Dodatki GFM

Listy zadań i przypisy jadą razem z GFM:

• tokeny zaimportowane
• base.css zaimportowany
• paleta tożsamości nadpisana

Twierdzenie warte źródła dostaje przypis.¹

§4.1Co strażnik odrzuca na tej stronie

To, że ta strona się buduje, samo w sobie dowodzi, że wszystko powyżej jest poprawnie złożone. Poniższe pisownie wywróciłyby build na miejscu (wypróbuj jedną, potem npm run build):

• znak wyróżnienia bez pary, jak ** zostawione niedomknięte na końcu linii;
• jednoliniowe $$x$$ (użyj formy trzyliniowej);
• ręcznie numerowane nagłówki — zapisanie nagłówka tej sekcji jako ## 9. Co strażnik… zderzyłoby się z numeracją nadawaną w czasie budowania i zostałoby oflagowane;
• MDX wyliczający klamry w twojej prozie: {0,1,2,3} wyrenderowałoby się jako samo 3, więc strażnik żąda formy z ukośnikami {0,1,2,3};
• wzór, którego KaTeX nie umie wyrenderować (strażnik przelicza każdy wzór w trybie ścisłym, zamiast pozwolić czerwonemu tekstowi błędu wypłynąć na produkcję).