# contentbit (Content Blocks)

> Structured Markdown components for LLM-written content. LLMs write plain
> Markdown with directive blocks (:::callout, :::comparison, ...). The library
> parses to a source-mapped AST, validates against per-block schemas with
> file:line:col diagnostics, and renders through React, Astro, or a
> plain-Markdown fallback. npm scope: @contentbit. CLI:
> `npx contentbit@latest init`.

## Start here

- [Authoring rules](https://contentbit.dev/contentbit-guide.md): the generated block-authoring instructions — paste these into a system prompt before writing Content Blocks documents
- [Full documentation as one file](https://contentbit.dev/llms-full.txt)

## Docs

- [Get started with programmatic SEO](https://contentbit.dev/docs): Scaffold Contentbit, define one page family, create a brief, and validate the finished page.
- [Changelog](https://contentbit.dev/docs/changelog): What shipped in each release.
- [Stability and compatibility](https://contentbit.dev/docs/compatibility): The interfaces Contentbit 1.x will keep stable and how changes are classified.
- [LLM & agent authoring](https://contentbit.dev/docs/concepts/llm-authoring): How generated authoring instructions keep schemas, docs, prompts, and validation aligned.
- [Rendering model](https://contentbit.dev/docs/concepts/rendering-model): How parsing, validation, Markdown rendering, and framework adapters fit together.
- [Block syntax moved](https://contentbit.dev/docs/concepts/syntax): The syntax page now lives in the Reference section.
- [Why contentbit?](https://contentbit.dev/docs/concepts/why-contentbit): The content model behind typed Markdown blocks, validation, renderers, and LLM-agent workflows.
- [Why not MDX?](https://contentbit.dev/docs/concepts/why-not-mdx): MDX embeds components. Content Blocks defines a content protocol.
- [Adopt an existing content library](https://contentbit.dev/docs/guides/adoption): Inspect an existing Markdown library, find integrity issues, and generate reviewable Contentbit setup proposals without modifying files.
- [LLM-agent integration](https://contentbit.dev/docs/guides/agents): Give Codex, Claude Code, Cursor, Copilot, and other LLM agents a fast validated writing loop.
- [Astro](https://contentbit.dev/docs/guides/astro): Render validated documents with .astro components — renderer only, one validation path.
- [Defining custom blocks](https://contentbit.dev/docs/guides/custom-blocks): Add project-specific blocks in under 20 lines with defineBlock.
- [Content doctor](https://contentbit.dev/docs/guides/doctor): Run validation, link checks, content-quality heuristics, and optional SEO contract checks as one ranked repair plan.
- [Internal linking](https://contentbit.dev/docs/guides/internal-linking): Build and validate a frontmatter-authored internal-link graph with contentbit links.
- [Plug in your Markdown library](https://contentbit.dev/docs/guides/markdown): One function connects Content Blocks to react-markdown, marked, markdown-it, or remark. Step-by-step for each.
- [Start from the production Astro template](https://contentbit.dev/docs/guides/production-astro): Use astro-speedrun-seo when you want Contentbit inside a complete multilingual SEO site.
- [Build a programmatic SEO workflow](https://contentbit.dev/docs/guides/programmatic-seo): Define a page family, brief a writer or agent, inspect the result, and enforce the contract in CI.
- [Configure a Contentbit project](https://contentbit.dev/docs/guides/project-config): Add one shared config so Contentbit commands use the same content, blocks, links, and SEO contracts.
- [Render documents](https://contentbit.dev/docs/guides/renderers): Render a validated contentbit document in React, Astro, or plain Markdown.
- [SEO briefs and contracts](https://contentbit.dev/docs/guides/seo-briefs): Define page contracts and print agent-ready briefs for existing or planned pages.
- [Document stats & auditing](https://contentbit.dev/docs/guides/stats): analyzeDocument and contentbit stats — outlines, block usage, link domains, and validation summaries as JSON.
- [Content Studio](https://contentbit.dev/docs/guides/studio): Browse content health, previews, stats, links, backlinks, keywords, and SEO briefs in a read-only local web app.
- [Release checklist](https://contentbit.dev/docs/maintainers/release-checklist): The gates to run before publishing contentbit packages and starters.
- [Block reference](https://contentbit.dev/docs/reference/blocks): Every built-in block, generated from the registry.
- [CLI reference](https://contentbit.dev/docs/reference/cli): Commands, options, shared flags, and exit behavior for the contentbit CLI.
- [Configuration reference](https://contentbit.dev/docs/reference/configuration): Fields, defaults, discovery, paths, and command overrides for contentbit.config.*.
- [Block syntax](https://contentbit.dev/docs/reference/syntax): Directive fences, props, child blocks, pipe rows, Markdown bodies, and raw HTML behavior.
- [Release checklist moved](https://contentbit.dev/docs/release-checklist): The release checklist now lives in the Maintainers section.

## Blog

- ['contentbit 0.2.0: LLM agents write validated content'](https://contentbit.dev/blog/contentbit-0-2-0): One command installs LLM-agent skills that fetch the live authoring guide, write, and validate until clean. Plus document stats, an Astro renderer, and fully documented props.
- ["contentbit 0.3.0: internal links your content can't outgrow"](https://contentbit.dev/blog/contentbit-0-3-0): Author each page's place in the graph in frontmatter; contentbit derives backlinks, validates every reference, and heals renames with --fix. Internal linking that fails CI instead of your readers.
- [Why LLMs write broken Markdown (and how to make it impossible)](https://contentbit.dev/blog/llm-markdown-that-cannot-break): LLMs write Markdown that looks right and breaks in production. Prompting alone never fixes it. A validation contract does.

## Packages

- @contentbit/core: parser, validator, registry, authoring-guide generation
- @contentbit/blocks: the generic block pack
- @contentbit/react: headless React renderer
- contentbit: CLI — init, validate, stats, render, instructions, agents