Skip to content

The framework agnostic fastest and beautiful documentation tooling for JS/TS

Notifications You must be signed in to change notification settings

ubugeeei/ox-content

Repository files navigation

Ox Content

Ox Content Logo

Framework-agnostic documentation tooling
High-performance Markdown parser built in Rust

DocumentationGetting StartedPlayground


Features

  • Blazing Fast - Arena-allocated parser with zero-copy parsing
  • mdast Compatible - Full compatibility with the unified ecosystem
  • GFM Support - Tables, task lists, strikethrough, autolinks, footnotes
  • Multi-Runtime - Node.js (NAPI), WebAssembly, Native Rust
  • Framework Agnostic - Works with Vue, React, Svelte, and more
  • Built-in SSG - Static site generation with theming, search, and OG images
  • API Docs Generation - Generate docs from JSDoc/TypeScript (like cargo doc)

Quick Start

Basic Usage (Node.js)

npm install @ox-content/napi
import { parseAndRender } from '@ox-content/napi';

const { html } = parseAndRender('# Hello World', { gfm: true });

Vite Plugin

npm install @ox-content/vite-plugin @ox-content/napi
// vite.config.ts
import { defineConfig } from 'vite';
import { oxContent } from '@ox-content/vite-plugin';

export default defineConfig({
  plugins: [
    oxContent({
      srcDir: 'docs',
      outDir: 'dist/docs',
      highlight: true,
      ssg: {
        siteName: 'My Docs',
      },
    }),
  ],
});

Framework Integration

# Vue
npm install @ox-content/vite-plugin-vue @ox-content/napi

# React
npm install @ox-content/vite-plugin-react @ox-content/napi

# Svelte
npm install @ox-content/vite-plugin-svelte @ox-content/napi

Read the full documentation →

Development

pnpm install            # Install dependencies
mise run napi-build     # Build NAPI bindings
mise run npm-build      # Build npm packages
mise run test           # Run tests

See the documentation for more details.

Sponsor

If you find Ox Content useful, please consider sponsoring the project.

License

MIT License - see LICENSE

About

The framework agnostic fastest and beautiful documentation tooling for JS/TS

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •