Skip to main content

🧠 Guide: How to Create AI Assisted Knowledge Base Articles in Bookstack

📘 Purpose

This guide helps DTC team members properly document and migrate non-client-specific technical knowledge into Bookstack. This ensures consistent formatting, easy access, and high value for internal teams.

Note: Bookstack is the official place for general technical guides, internal process documentation, and reusable knowledge that isn’t tied to a specific client.

✍️ Creating and Cleaning Up Articles

When you find a useful guide (from IT Glue, personal notes, Slack, etc.), follow these steps to move it into Bookstack in a clean, readable format:

1. Copy the Guide Content

Grab the full body of the guide or note, including titles, steps, and notes. This could be something from:

  • IT Glue
  • Slack threads
  • Internal docs
  • One-off guides you've used before

2. Clean it Up Using ChatGPT

Paste the raw guide content into ChatGPT and ask:

"Clean up this guide and return it to me in markdown format."

This helps ensure the guide:

  • Uses clear formatting
  • Has consistent headings
  • Uses bullet points, code blocks, and emphasis correctly
  • Is easy to read in Bookstack

📚 Publishing in Bookstack

3. Create or Select the Appropriate Book

  • All general technical documentation should live under clearly titled books like:
    • Microsoft 365
    • Network & Security
    • Guides & Self-Help
  • If your content doesn’t yet have a home, propose a new book title.

You’ll soon see a dedicated book titled "Introduction to DTC's Technical Knowledge Base" that will explain the full structure and naming conventions.

4. Paste the Clean Markdown into Bookstack

Once ChatGPT returns the markdown:

  • Log into Bookstack
  • Navigate to the relevant Book
  • Create a New Page
  • Paste the markdown content into the editor
  • Adjust formatting if necessary (preview first!)
  • Save and publish the page

For example, the Azure AD Connect setup guide was added here:

🔗 Azure AD Connect – Pre-Installation and Setup Guide

🏛️ Structure & Standards

A formal structure guide will be coming soon to help everyone follow the same patterns. It will live in the "Introduction to DTC's Technical Knowledge Base" book and will include:

  • Naming conventions
  • When to use a new page vs. update an existing one
  • Page hierarchy best practices
  • What content should stay in IT Glue vs. Bookstack

✅ Quick Recap

Task What to Do
Content Source Pull from IT Glue, Slack, docs, etc.
Clean-Up Use ChatGPT to format in Markdown
Publishing Add to Bookstack under the correct Book
Structure Follow the soon-to-be-published KB Structure Guide
Back to top