A lead paragraph.
Install
See Getting started and api/transform#options.
``` `[[target]]` uses the target as the label, `[[target|label]]` overrides it, and `#fragment` parts are slugified. Site-relative targets are prefixed with `baseUrl`. Wiki links also run before raw HTML is parsed, so `[[...]]` inside literal `` tags in embedded HTML is expanded too — keep literal examples inside
Markdown code spans or fences instead.
## Attribute Syntax
Add IDs, classes, and attributes with `markdown-it-attrs` syntax:
```ts
oxContent({
attrs: true,
});
```
Supported tokens are `#id`, `.class`, and `key=value`. A trailing `{...}` block
attaches to the element rendered from that line:
```md
A lead paragraph. {.lead}
## Install {.section data-section=install}
[Slides](https://example.com/slides){.deck-link data-kind=deck}
{.w-1/2 .mx-auto width=480}
```
produces:
```html
A lead paragraph.
Install
```
The transform runs as a post-render HTML pass over the full document — raw
HTML embedded in Markdown is affected as well, so literal `{...}` examples
belong in code spans or fences.
## CJK Emphasis
Emphasis adjacent to CJK characters needs no configuration — CommonMark's
delimiter rules already allow it, and no ASCII spaces are required:
```md
これは**重要**です。次の文でも*強調*できます。
```
Rendered:
これは**重要**です。次の文でも*強調*できます。
What plain CommonMark rejects is a delimiter run sitting directly against
punctuation on its outer side. Its flanking rules read Unicode punctuation as a
whole, so East Asian punctuation blocks a run just like ASCII punctuation does,
and `A**強調。**B` stays literal text. Latin prose rarely hits this because a
space usually separates the two; CJK sets punctuation against the preceding
word, so it comes up constantly.
`cjkEmphasis` classifies East Asian punctuation as an ordinary character for
that decision only:
```ts
oxContent({
cjkEmphasis: true,
});
```
```md
A**強調。**B
```
renders as `A強調。B` with the option on, and as literal text
with it off. Halfwidth ASCII punctuation is deliberately untouched, so a Latin
document parses identically either way.
This is a deliberate deviation from the specification, which is why it is
opt-in. See [CJK Emphasis](../examples/cjk-emphasis.md) for the exact boundary
and the reclassified character ranges.
## Magic Links
Opt-in `{link:@user}`, `{link:alias}`, and `{link:label|url}` rich links with
optional avatars. Off by default. See [Magic Links](./magic-links.md).
## Cross References
Opt-in `@sec-*`, `@fig-*`, and `@tbl-*` references link to labeled headings,
figures, images, and tables. Off by default. See
[Cross References](./cross-references.md).
## Citations
Opt-in `[@key]` and `[@key; -@other]` references link to generated bibliography
entries loaded from local CSL JSON. Off by default. See
[Citations](./citations.md).
## BudouX
Opt-in `budoux` inserts zero-width spaces into visible prose at build time for
better Japanese line breaking. It leaves tags, attributes, URLs, entities,
code, raw HTML blocks, and island JSON payloads unchanged. Off by default. See
[BudouX](./budoux.md).
## NotByAI Badge
Opt-in `