Hepsi bir arada

§1.1Satır içi imler

Vurgu ayrıştırması CJK dostudur: kalın, Çince noktalama işaretlerine yaslanınca da kapanır — **报文。**同时, iki yalın yıldız olarak değil, 报文。同时 olarak çizilir. İtalik, üstü çizili ve satır içi kod her zamanki gibi çalışır; gemoji anahtarı açıkken :sparkles: gibi bir kısayol ✨ olarak görünür. Satır içi kodun içindeki karakterler hiçbir ayrıştırmaya girmez; sözdizimini göstermenin güvenli yolu bu yüzden ters tırnaktır: **, $…$ ve > [!note] üçü de olduğu gibi görünür. Düz metinde yıldızın kendisini göstermek içinse kaçış kullanın — *böyle* yalın kalır.

§1.2Wikilink’ler

wikilinks anahtarı açıkken [[çift köşeli]] bağlantılar, bir wikinin beklediği gibi not koleksiyonuna karşı çözülür: id ile (design-tokens — Türkçe bir ayna sayfadan bakınca önce aynı dildeki ayna bulunur, ancak o yoksa İngilizce asıl nota düşülür), takma adla (boundaries, id’si three-way-split olan nota ulaşır) ve okunabilir etiketle (hızlı başlangıç rehberi). Hiçbir şeye çözülmeyen bir hedef, derlemeyi düşürmek yerine işaretli bir ölü bağlantı olarak çizilir — motorun check-wikilinks CLI’si onu CI’da raporlar; bağlantı çürümesinin yeri orasıdır.

§1.3Tablolar: genişse kaydırma, darsa kart

Altı ve daha çok sütunlu bir tablo, dar bir kapta her hücreyi iki karaktere sıkıştırmak yerine satır başına bir karta dönüşmelidir. Aşağıdaki yedi sütunlu tablo hem callout varyantlarının kopya kâğıdı hem de bu dönüşümün canlı sınamasıdır (pencereyi telefon genişliğine daraltın):

Varsayılan başlıklar İngilizcedir; bir site bütün takımı siteMarkdown’ın calloutLabels seçeneğiyle değiştirir, örneğin calloutLabels: { tip: 'Sezgi · Intuition', warn: 'Uyarı · Warning' }. Alıntı sözdiziminde yazılan başlık (> [!tip] Kendi başlığım) her zaman kazanır.

§2.1Callout: üç yazım

Birincisi, Obsidian/GitHub alıntı sözdizimi (callouts: true ile gelir; düz Markdown dosyalarında da çalışır):

Obsidian’ın katlama imi de tanınır — > [!note]- katlanmış, > [!note]+ açık çizilir:

İkincisi, MDX’te paket bileşeni (astro-inkstone/components/Callout.astro, yoldan import edilir). title verilmezse varyantın varsayılan etiketini gösterir — alıntı sözdiziminin kullandığının aynısını:

Üçüncüsü, ham HTML — altı varyantın hepsi bir arada (base.css’in .callout kurallarıyla bire bir):

§2.2Matematik

Satır içi formüller metnin içinde oturur: optik derinlik $\tau = \int \kappa \rho \, \mathrm{d}s$ diye okunur. Blok matematik üç satırlık biçimi alır ($$ kendi satırlarında) — bekçi tek satırlık biçimi reddeder, çünkü o biçim sessizce küçük bir satır içi formüle dönüşür:

Formül zemini bilerek gövdeninkinden ayrı bir kâğıttır ve temayla birlikte değişir. Bu arada, düz metindeki dolar fiyatlarını kaçışlayın: bu kahve $3 eder.

§3.1Kod çerçeveleri

title="…" taşıyan bir kod bloğu dosya adlı bir başlık çubuğu alır; köşedeki kopyalama düğmesi site genelidir. [!code ++] / [!code --] satır imleri diff zeminleri olarak çizilir:

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

collapse işaretli bir çerçeve katlanmış başlar ve yalnızca açıldığında yer kaplar — uzun yapılandırma dosyaları için biçilmiş kaftan:

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

Çift temalı vurgulama, shiki’nin iki renk takımını aynı anda üretmesinden gelir; base.css hangisinin kullanılacağını data-theme üzerinden tek bir yerde seçer — özgüllük çekişmesi yoktur.

§3.2Mermaid diyagramları

Bir ```mermaid bloğu derleme sırasında yalnızca bir yer tutucu bırakır; çizici, sadece diyagram taşıyan sayfalarda dinamik olarak yüklenir (diyagramsız sayfalar hiçbir bedel ödemez) ve tema değişince yeniden çizer:

flowchart LR
  A["astro-inkbrush<br/>motor: düzenleme / lehçe / bekçi"] --> C["sizin siteniz<br/>kimlik / rotalar / dağıtım"]
  B["astro-inkstone<br/>kâğıt: token’lar / stiller / işlem hattı"] --> C
  A -. tek ortak lehçe .-> B

§3.3GFM ekleri

Görev listeleri ve dipnotlar GFM ile birlikte gelir:

• token’lar import edildi
• base.css import edildi
• kimlik paleti geçersiz kılındı

Kaynak göstermeye değer bir iddia dipnot alır.¹

§4.1Bekçinin bu sayfada reddettikleri

Bu sayfanın derlenebiliyor olması, yukarıdaki her şeyin düzgün biçimli olduğunun kanıtıdır. Şu yazımlar derlemeyi anında düşürür (birini deneyin, sonra npm run build çalıştırın):

• eşleşemeyen bir vurgu imi — satır sonunda açık bırakılmış bir ** gibi;
• tek satırlık $$x$$ (üç satırlık biçimi kullanın);
• elle numaralanmış başlıklar — bu bölümün başlığını ## 9. Bekçinin reddettikleri… diye yazmak, derleme zamanı numaralandırmayla çakışır ve yakalanır;
• düz metindeki süslü ayraçların MDX tarafından değerlendirilmesi: {0,1,2,3} yalnızca 3 olarak çizilirdi — bekçi bu yüzden kaçışlı biçimi ister: {0,1,2,3};
• KaTeX’in çizemediği bir formül (bekçi her formülü strict kipte yeniden çizer; kırmızı hata metninin yayına çıkmasına izin vermez).