Creating content in Bulkhead OS is straightforward. Open Semantic Graph → Library in the sidebar, click New Node, and start writing.
Creating a New Page
- Navigate to Semantic Graph → Library in the sidebar
- Click New Node
- Select a content type
- Enter a title — the URL slug is generated automatically
- Write your content in the editor
- Set the status to Published when you're ready
The Editor
The content editor supports:
- Rich text formatting — headings, bold, italic, lists, links
- Code blocks — syntax highlighted, with language detection
- Media embedding — images, videos, and iframes
- HTML mode — drop down to raw HTML for full control
Preview & Highlighting
Preview rendering uses the same Markdown pipeline your site uses in production. When a code fence includes a language, Bulkhead OS can render a syntax-highlighted preview with Shiki-backed themes for both light and dark reading modes.
POST /api/v1/editor-preview
Content-Type: application/json
Authorization: Bearer ENGINE_ADMIN_TOKEN
{
"markdown": "# Example\n\n~~~ts\nconsole.log('hello from Bulkhead')\n~~~",
"theme": "dark"
}Authoring tip: Keep examples short enough to scan, but concrete enough to copy. If a paragraph explains an API, include the real request shape directly underneath it.
URL Slugs
Each piece of content gets a URL based on its slug. Slugs are auto-generated from the title but you can customize them. Once published, changing a slug automatically creates a redirect from the old URL.
Important: Content must be assigned a placement (a public URL) to be visible on your site. The Library lets you manage both the content and its URL assignment in one place.
For a fuller example gallery, continue to Code Blocks & Shiki.