Serba ada

§1.1Tanda sebaris

Penguraian emphasis-nya ramah CJK: tebal tetap menutup meski menempel tanda baca Tionghoa — **报文。**同时 dirender sebagai 报文。同时, bukan sebagai asterisk mentah. Miring, coretan, dan kode sebaris bekerja seperti biasa; dengan sakelar gemoji, shortcode seperti :sparkles: dirender sebagai ✨. Karakter di dalam kode sebaris tidak ikut penguraian apa pun, jadi backtick adalah cara aman untuk memperlihatkan sintaks: **, $…$, dan > [!note] semuanya tampil apa adanya. Untuk menampilkan asterisk di tubuh kalimat, lepaskan dengan garis miring terbalik — *seperti ini* tetap polos.

§1.2Tautan wiki

Dengan sakelar wikilinks menyala, tautan [[kurung-ganda]] diresolusi terhadap koleksi catatan sebagaimana lazimnya wiki: per id (design-tokens — dan dari halaman cermin seperti ini, tautan mendarat lebih dulu di cermin sebahasa bila ada, baru jatuh ke catatan Inggris kanonisnya), per alias (boundaries sampai ke catatan yang id-nya three-way-split), dan dengan label (panduan memulai). Target yang tak teresolusi dirender sebagai tautan mati yang ditandai, bukan menggagalkan build — dan CLI check-wikilinks milik mesin melaporkannya di CI, tempat pembusukan tautan seharusnya ketahuan.

§1.3Tabel: menggulir saat lebar, jadi kartu saat sempit

Tabel dengan enam kolom atau lebih semestinya mengalir ulang menjadi satu baris per kartu di wadah sempit, alih-alih memeras tiap sel jadi dua karakter. Tabel tujuh kolom ini sekaligus contekan varian callout dan uji langsung reflow itu (ciutkan jendela ke lebar ponsel):

Judul bawaannya bahasa Inggris; sebuah situs menukar seluruh setnya lewat opsi calloutLabels milik siteMarkdown, mis. calloutLabels: { tip: 'Intuisi' }. Judul yang ditulis dalam sintaks kutip (> [!tip] Judul saya) selalu menang.

§2.1Callout: tiga ejaan

Pertama, sintaks kutip gaya Obsidian/GitHub (tersedia dengan callouts: true, jalan juga di berkas Markdown polos):

Penanda lipat Obsidian dihormati — > [!note]- dirender terlipat, > [!note]+ terbuka:

Kedua, komponen paketnya di MDX (astro-inkstone/components/Callout.astro, diimpor per jalur). Tanpa title ia menampilkan label bawaan variannya, label yang sama dengan yang dipakai sintaks kutip:

Ketiga, HTML mentah, keenam varian sekali jalan (berpadanan satu-satu dengan aturan .callout di base.css):

§2.2Matematika

Rumus sebaris duduk di dalam teks: kedalaman optis terbaca $\tau = \int \kappa \rho \, \mathrm{d}s$. Matematika blok memakai bentuk tiga baris ($$ di barisnya sendiri) — penjaga menolak bentuk satu-baris, yang akan diam-diam dirender sebagai rumus sebaris kecil:

Dasar rumus sengaja dibuat dari kertas yang berbeda dari tubuh teks, dan berganti mengikuti tema. Omong-omong, lepaskan harga berlambang dolar di tubuh kalimat: kopi ini harganya $3.

§3.1Bingkai kode

Blok berpagar dengan title="…" mendapat bilah judul bernama berkas; tombol salin di pojoknya berlaku seluruh situs. Anotasi baris [!code ++] / [!code --] dirender sebagai dasar diff:

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

Bingkai bertanda collapse mulai dalam keadaan terlipat dan baru memakan tempat saat dibuka — pas untuk berkas konfigurasi panjang:

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

Pewarnaan dwi-tema datang dari shiki yang memancarkan kedua set warna sekaligus; base.css memilih salah satunya lewat data-theme di satu tempat saja — tanpa tarik-menarik spesifisitas.

§3.2Diagram mermaid

Blok berpagar ```mermaid hanya meninggalkan placeholder saat build; perendernya dimuat dinamis hanya di halaman yang membawa diagram (halaman tanpa diagram tak membayar apa pun), dan merender ulang saat tema dibalik:

flowchart LR
  A["astro-inkbrush<br/>engine: editing / dialect / guard"] --> C["your site<br/>identity / routing / deploy"]
  B["astro-inkstone<br/>paper: tokens / styles / pipeline"] --> C
  A -. one shared dialect .-> B

§3.3Ekstra GFM

Daftar tugas dan catatan kaki ikut serta bersama GFM:

• token sudah diimpor
• base.css sudah diimpor
• palet identitas sudah ditimpa

Klaim yang layak diberi sumber mendapat catatan kaki.¹

§4.1Apa yang ditolak penjaga di halaman ini

Bahwa halaman ini terbangun sudah menjadi bukti bahwa semua di atas well-formed. Ejaan-ejaan berikut akan menggagalkan build di tempat (coba salah satunya, lalu npm run build):

• penanda emphasis yang tak bisa berpasangan, seperti ** yang dibiarkan terbuka di ujung baris;
• $$x$$ satu-baris (pakai bentuk tiga baris);
• judul bernomor tangan — menulis judul bagian ini sebagai ## 9. Apa yang ditolak penjaga… akan bertabrakan dengan penomoran saat build dan ditandai;
• kurung kurawal prosa yang dievaluasi MDX: {0,1,2,3} akan dirender sebagai sekadar 3, maka penjaga menuntut bentuk lepasnya {0,1,2,3};
• rumus yang tak bisa dirender KaTeX (penjaga merender ulang setiap rumus dalam mode ketat alih-alih membiarkan teks galat merah terkirim).