Author and publish documentation
Write docs in Git or the admin CMS, preview changes, publish revisions, and update search and sitemap outputs.
CrawlConsole documentation supports two authoring paths: repository Markdown for Git workflows and a web CMS for editorial workflows. Both feed the same public content index.
Author in Git
Add Markdown files under content/docs. Frontmatter controls navigation, search, access, SEO, and sitemap behavior.
---
title: "Page title"
description: "A concise page summary."
section: "Guides"
sectionOrder: 70
navigationOrder: 20
keywords: [keyword one, keyword two]
priority: 0.7
---
Write the page in Markdown.
Run the app locally and open /docs to preview repository content.
Author in the CMS
Platform admins can open Admin and Documentation to:
- create a page;
- edit Markdown with a live preview;
- set the slug, section, locale, version, visibility, SEO, and sitemap fields;
- save drafts without changing the published page;
- publish a revision;
- restore an earlier revision;
- archive or delete CMS pages;
- review docs traffic, searches, and feedback.
A published CMS page overrides a repository page with the same slug, locale, and version. Draft edits remain private until the next publish action.
Publish outputs
One publish action updates:
- the HTML page;
- sidebar and top-level documentation navigation;
- search results;
- the
search_docsMCP tool; .md,llms.txt, andllms-full.txtexports;- the dedicated docs sitemap;
- the changelog RSS feed when the page is in the Changelog section.
Access and personalization
CMS pages can be public, authenticated, or admin-only. Public sitemap and agent exports include only public, indexable pages. Locale and version fields allow alternate published variants without duplicating the renderer.
Was this page helpful?
Feedback helps prioritize documentation updates.
