Components
Clearify ships with a set of built-in MDX components you can use in any .mdx file.
Callout
Use callouts to highlight important information.
This is an informational callout for general notes.
This is a warning callout for things to watch out for.
This is an error callout for critical issues.
This is a tip callout for helpful suggestions.
Tabs
Use tabs to show alternative content side by side.
Steps
Use steps for sequential instructions.
Add Clearify to your project as a dev dependency.
Create a docs/ directory and add your first markdown file.
Run npx clearify dev to see your docs at http://localhost:4747.
Cards
Use cards to link to related pages or highlight features.
CodeGroup
Use code groups to show the same concept in multiple languages.
Mermaid Diagrams
Use fenced code blocks with the mermaid language to render diagrams.
graph TD
A[Write Markdown] --> B[Clearify Builds]
B --> C[Static Site]
B --> D[Dev Server]
C --> E[Deploy Anywhere]
D --> F[Live Reload]
sequenceDiagram
participant U as User
participant C as Clearify CLI
participant V as Vite
U->>C: clearify dev
C->>V: createServer()
V-->>U: http://localhost:4747
U->>V: Edit .md file
V-->>U: Hot reload
StatusBadge
Display a color-coded project status pill.
Active Beta Planned DeprecatedProjectCard
A card component for displaying project information with an optional status badge, tags, and links.
ProjectGrid
A responsive grid layout for project cards. Renders 3 columns by default, collapsing to 2 and then 1 on smaller screens.