create-knowledge-base-page

To publish a Markdown knowledge-base page, you provide the category, slug, title, content, and nav_order inputs to generate a file under docs/<category>/<slug>.md with the required YAML frontmatter.

Structuring a Markdown file for a Jekyll documentation website requires YAML frontmatter containing name, title, description, and nav_order. This metadata ensures the page integrates correctly into the site's navigation and category index.

Updating the navigation index when adding a knowledge base page is handled automatically by validating category, slug, and nav_order inputs, then updating the category index file to include the new document.

Yes, you can generate documentation pages under a specific category directory by providing the category and slug inputs, which places the final Markdown file directly under docs/<category>/<slug>.md.

A limitation of automating Markdown page creation is the strict dependency on validating specific inputs like category, slug, title, and content, meaning incomplete metadata will prevent generating the knowledge-base document.