# Rich Text

## Essence

Design-system wrapper for Wiki-published long-form content.

`Rich Text` gives Portfolio a future mapping layer between semantic Markdown and visual article/use-case presentation.

## Hook

Use after an explicit migration from generic Markdown rendering to Rich Text mapping.

## Internal Rules

- Does not consume Rich Text spacing itself.
- Composes Rich Text child components in source order.
- Child components consume Rich Text spacing and own their own readable content columns.
- Composes only Rich Text child components.
- Does not replace page shells, article headers, article cards, or related-content blocks.
- Not wired into production article or use-case pages yet.

## Mapping Intent

- Markdown paragraphs map to `Rich Text Paragraph`.
- Markdown h2 maps to `Rich Text Heading`.
- Markdown h3 maps to `Rich Text Subheading`.
- Markdown lists map to `Rich Text List`.
- Markdown blockquotes map to `Rich Text Quote`.
- Markdown images map to `Rich Text Image`.
- Markdown fenced code maps to `Rich Text Code Block`.

## Code Paths

- `packages/design-system/src/components/RichText.astro`
- `apps/portfolio-site/src/pages/design-system/index.astro`