See Getting started and api/transform#options.
``` `[[target]]` はターゲットをラベルにし、`[[target|label]]` で上書きします。`#fragment` 部分は slug 化します。サイト相対のターゲットには `baseUrl` を付けます。 Wiki リンクは生 HTML のパースよりも前に走るので、埋め込み HTML のリテラル `` タグの中の `[[...]]` も展開されます。リテラルの例は Markdown のコードスパンかフェンスに置いてください。
## 属性構文
`markdown-it-attrs` 構文で ID、クラス、属性を足します。
```ts
oxContent({
attrs: true,
});
```
対応するトークンは `#id`、`.class`、`key=value` です。末尾の `{...}` ブロックは、その行から描画された要素に付きます。
```md
A lead paragraph. {.lead}
## Install {.section data-section=install}
```
結果は次です。
```html
A lead paragraph.
Install
```
変換は文書全体に対する描画後の HTML パスです。Markdown に埋め込んだ生 HTML も影響を受けるので、リテラルの `{...}` 例はコードスパンかフェンスに置いてください。
## CJK 強調
CJK 文字に隣接する強調に設定は不要です。CommonMark の区切り規則がすでに許しており、ASCII スペースも要りません。
```md
これは**重要**です。次の文でも*強調*できます。
```
描画:
これは**重要**です。次の文でも*強調*できます。
素の CommonMark が拒否するのは、区切りランが外側で句読点に直接接している場合です。隣接規則は Unicode 句読点を一括して読むので、東アジアの句読点は ASCII 句読点と同じようにランを止め、`A**強調。**B` はリテラルのままです。ラテン語の本文では間にスペースが入ることが多いので、あまり当たりません。CJK は句読点を直前の語に付けるので、日常的に起きます。
`cjkEmphasis` はその判定に限って、東アジアの句読点を普通の文字として分類します。
```ts
oxContent({
cjkEmphasis: true,
});
```
```md
A**強調。**B
```
オプションがオンなら `A強調。B` になり、オフならリテラルのままです。半角 ASCII 句読点は意図して触らないので、ラテン文書のパースはどちらでも同じです。
これは仕様からの意図した逸脱なので、オプトインです。境界と再分類する文字範囲の正確な話は [CJK Emphasis](/examples/cjk-emphasis.md) を見てください。
## マジックリンク
オプトインの `{link:@user}`、`{link:alias}`、`{link:label|url}` リッチリンクです。アバターも付けられます。既定はオフです。詳細は [マジックリンク](./magic-links.md) を見てください。
## 相互参照
`@sec-*`、`@fig-*`、`@tbl-*` を、label 付きの見出し、figure、画像、表へのリンクにします。既定はオフです。詳細は [相互参照](./cross-references.md) を見てください。
## 引用
`[@key]` と `[@key; -@other]` を、ローカル CSL JSON から生成した bibliography entry へのリンクにします。既定はオフです。詳細は [引用](./citations.md) を見てください。
## BudouX
オプトインの `budoux` は、より自然な日本語改行のために visible prose へ zero-width space をビルド時に挿入します。tag、attribute、URL、entity、code、生 HTML block、island JSON payload は変えません。既定はオフです。詳細は [BudouX](./budoux.md) を見てください。
## NotByAI バッジ
オプトインの `