How-to

Turn Your Internal Wiki into an AI Assistant: Notion, Confluence and Docs Exports That Actually Work

The Kopik team10 min read

The quickest route to a working wiki AI assistant is to export your Notion, Confluence or Google Docs pages, clean up the structure, split the content into sensibly sized chunks, index it for hybrid search, and then keep that index in sync every time someone edits a page. Skip any of those steps and you end up with an assistant that confidently quotes a policy your HR team retired eighteen months ago.

Why a wiki search bar and an AI assistant are not the same thing

Notion AI and Confluence AI both offer built-in question-answering, but they only search inside their own walled garden. The moment your organisation's knowledge is spread across a Confluence space, a folder of Google Docs, a Slack export and a pile of PDFs from suppliers, those native tools stop being useful. A proper wiki AI assistant needs to pull from all of those sources into one index, so an employee can ask a single question and get an answer grounded in whichever document actually contains it, with a citation back to the source page.

This matters because wikis are written for browsing, not for retrieval. People scan a table of contents, follow links, and build context as they go. An AI assistant has to reconstruct that context in a single pass over a short chunk of text, which is a different problem from keyword search. If you want the underlying mechanics, Semantic Search Explained: Meaning-Based Search vs Keywords covers why meaning-based retrieval finds the right paragraph even when the employee's question uses completely different words from the page title.

Exporting from Notion, Confluence and Google Docs

Every platform exports differently, and the format you choose has a direct impact on how well the assistant performs later. The goal is to preserve headings, tables and page hierarchy as plain text or Markdown, because that structure is exactly what a chunking algorithm uses to decide where one topic ends and the next begins.

Notion

Notion's workspace export (Settings, then Export all workspace content) produces Markdown or HTML files, with nested pages mirrored as folders. Markdown is almost always the better choice: it keeps headings as #, bullet lists as lists, and tables as pipe-delimited rows, all of which survive the trip into a document parser far more cleanly than HTML. Watch out for Notion's toggle lists and synced blocks, which sometimes export as flattened text with the collapsible structure lost, and for databases, which export as one CSV or Markdown table per database view rather than as individual pages.

Confluence

Confluence offers a space export to PDF, HTML or XML (via Confluence's own export tooling, or the REST API for larger spaces). PDF is the worst option for an AI assistant: page breaks and two-column macros scramble reading order and headings lose their semantic tags, so a chunker sees a wall of text instead of a structured document. HTML export, or pulling pages through Confluence's REST API as storage-format XHTML, keeps headings, tables and macros (like status boxes or expand panels) identifiable, which makes for much cleaner chunks.

Google Docs and Drive

Google Workspace lets you download individual docs as Word (.docx), PDF, or plain text, and Google Takeout will bulk-export an entire Drive. Word format usually preserves headings and tables best if your documents were actually styled with Heading 1 and Heading 2 rather than just bold, bigger text, so it is worth a quick pass through your most-used docs to apply proper styles before exporting at scale.

Export format comparison for wiki content

SourceBest export formatWhat survivesCommon pitfall
NotionMarkdown (workspace export)Headings, lists, tables, page nestingToggle lists and synced blocks can flatten
ConfluenceHTML or REST API (storage XHTML)Headings, tables, macrosPDF export scrambles reading order
Google Docs/DriveWord (.docx)Headings and tables, if styled properlyUnstyled text has no detectable structure

Structuring the export before you index it

A raw export is not ready to feed into an assistant. Three things need attention before indexing: flattening nested pages into a sensible hierarchy (so a sub-page about expense limits doesn't lose its connection to the parent Finance policy), removing boilerplate that repeats on every page (navigation menus, footers, 'last updated by' stamps), and choosing a chunking strategy that respects your document structure rather than cutting mid-sentence at a fixed character count.

  • Keep headings attached to the paragraphs they introduce, don't chunk purely by length
  • Treat each table as its own chunk so rows aren't separated from their column headers
  • Carry the page title and breadcrumb into each chunk's metadata, so a citation can point back to 'HR Handbook > Leave > Parental Leave' rather than just 'Page 14'
  • Strip repeated headers, footers and 'related articles' widgets before indexing
  • Re-chunk whenever a page's structure changes significantly, not just when the text changes

If you want a deeper comparison of fixed-size, sentence-based and structure-aware approaches, Chunking Strategies for RAG: Fixed-Size, Sentence, Semantic and Structure-Aware walks through the trade-offs with concrete examples. For a wiki, structure-aware chunking that respects headings almost always outperforms naive fixed-size splitting, because wiki authors already did the hard work of organising information into logical sections.

Keeping the assistant fresh as the wiki changes

A one-off export solves day one. The harder problem is day ninety, when three teams have edited the handbook, a product page has been archived, and nobody told the assistant. There are three realistic patterns for keeping a wiki AI assistant current.

  1. Scheduled re-export: pull a fresh export weekly or monthly and re-index from scratch. Simple to run, but there's a lag between an edit and the assistant knowing about it.
  2. Event-driven sync: use Confluence or Notion webhooks to trigger a re-index of just the changed page the moment it's published. More engineering work, but near real-time freshness.
  3. Manual re-upload on major changes: fine for smaller teams where a wiki owner knows exactly when a policy changes and can trigger a re-index themselves.

Whichever cadence you pick, make sure old chunks are replaced rather than simply added to, otherwise the assistant may cite both the current and the superseded version of a policy in the same answer. If you're budgeting for an ongoing sync process, What Does RAG Really Cost? Ingestion, Storage, Retrieval and Generation Explained breaks down where re-indexing costs actually show up, which is useful when deciding between weekly batch refreshes and real-time webhooks.

Start with one space, not the whole wiki

Pick your messiest, most-asked-about space (usually HR, IT support or onboarding) and get the export, structure and freshness loop right there first. A assistant that's reliable on one space builds trust fast; a assistant that's shaky across the entire wiki on day one undermines confidence before it's had a chance to prove itself.

Permissions: who can ask what

Confluence and Notion both have page-level and space-level permissions that took years to configure properly. An AI assistant built on top of that content has to respect the same boundaries, or it becomes the easiest way to leak a restricted page to someone who was never meant to see it. In practice this means one of two approaches: either index everything into a single base but filter results by the querying user's permission group at retrieval time, or create separate knowledge bases per sensitivity tier (general company wiki, HR-only, finance-only) and restrict access to each one independently.

The second approach is simpler to reason about and far easier to audit. On Kopik, a knowledge base can be created as private, meaning only the owner's account and their API keys can query it, which suits an HR handbook or a legal playbook that shouldn't be answerable by the whole company. General onboarding material or a public product wiki, on the other hand, is a reasonable candidate for a more open base. If you're specifically digitising an HR handbook, An AI Assistant for HR Policies: Turning Your Handbook Into a Knowledge Base Employees Can Question goes into the access-control questions that come up with sensitive personnel content. And before any of this goes live with personal data in scope, run through UK GDPR and RAG: What to Check Before You Build a Knowledge Base, since exporting and re-indexing wiki pages that mention named individuals brings UK GDPR obligations with it, not just an internal IT decision.

Querying the assistant: web, API or inside the tools people already use

Once the wiki content is indexed, people need a way to actually ask it questions. A dedicated web page works for occasional use, but adoption climbs when the assistant is reachable from wherever the question arose: a developer asking from Cursor, a support agent asking from their ticketing tool, or a manager asking from Claude or ChatGPT while drafting an email. Kopik exposes each knowledge base through three channels: directly on the website, through a REST API documented at /developers for custom integrations, and through an MCP server that Claude, Cursor, ChatGPT and other MCP-compatible clients can call directly. If you want the exact setup steps for connecting an assistant to an editor or chat client, Connect Claude, Cursor or ChatGPT to a Knowledge Base covers the configuration end to end. Under the hood, good retrieval usually combines keyword matching with semantic similarity rather than relying on either alone, which is the subject of Hybrid Search: Why BM25 Plus Vectors Beats Either Alone for RAG.

Measuring adoption and quality

Launching a wiki AI assistant without measuring it is a common way to lose executive support within a quarter, because nobody can say whether it's actually helping. Track a small set of numbers from week one rather than trying to build a full analytics dashboard.

  • Query volume per week, segmented by team, to see which spaces people actually use the assistant for
  • Deflection: how many questions that used to go to a Slack channel or an HR inbox are now answered directly
  • Citation click-through: whether people are opening the cited source page, which signals they trust the answer enough to verify it
  • Faithfulness: whether answers are actually supported by the cited passages, not just plausible-sounding text
  • 'No answer found' rate, which usually points to a gap in the wiki itself rather than a retrieval failure

For faithfulness and citation accuracy specifically, How to Evaluate a RAG System: Retrieval Metrics, Faithfulness and Citation Accuracy sets out a practical testing method, including how to build a small set of known-answer questions from your own wiki to spot-check the assistant after every re-index.

Build your wiki assistant on Kopik

Upload your Notion, Confluence or Google Docs export, let Kopik handle chunking and hybrid search indexing, and query it from the website, the API, or directly from Claude, Cursor or ChatGPT.

Whichever platform your wiki lives in today, the underlying recipe is the same: export in a structure-preserving format, chunk by heading rather than by character count, re-sync on a cadence you can actually maintain, separate sensitive content into its own access-controlled base, and measure whether people are actually using and trusting the thing you built.

Frequently asked questions

Can I connect Notion or Confluence directly instead of exporting files?

Some platforms offer live API access instead of a one-off export, which is better for freshness because you can re-pull only the pages that changed. For a first pass, however, exporting to Markdown or HTML and uploading that is simpler to get right, since you can inspect and clean the files before they're indexed.

How do I stop the assistant answering from an outdated wiki page?

Replace chunks rather than append them on every re-index, archive or delete pages from the source wiki promptly, and run a scheduled or event-driven sync so stale content doesn't sit in the index for months. A periodic spot-check against known-current answers also catches drift early.

Will a wiki AI assistant expose content to people who shouldn't see it?

Only if permissions aren't carried across from the wiki. The safer pattern is to split content into separate knowledge bases by sensitivity (general wiki, HR, finance) and restrict access to each one, rather than relying on a single index to filter results correctly at query time.

Does this replace Notion AI or Confluence AI?

Not necessarily. Notion AI and Confluence AI work well for searching within their own platform. A dedicated wiki AI assistant becomes valuable once your knowledge spans multiple tools, formats or spaces that those native features can't see across, or when you need the assistant reachable through an API or an MCP client rather than only inside the wiki itself.

How much does it cost to turn a wiki into an AI assistant?

Costs come from three places: one-off ingestion of the export, ongoing storage of the index, and per-question retrieval and generation costs. Kopik's model uses prepaid credits per question or a flat chat subscription, which makes the ongoing cost predictable rather than tied to infrastructure you have to manage yourself.

What is the best chunk size for wiki pages?

There's no single number that works everywhere, because it depends on how your pages are structured. Structure-aware chunking, splitting by heading and keeping tables intact, generally outperforms a fixed character count for wiki content, since wiki authors have already organised the material into logical sections for you.

Get the Kopik newsletter

New knowledge bases, RAG guides and product news. One email every week or two, unsubscribe in one click.

By subscribing you agree to receive our newsletter. We never share your address.

Turn Your Wiki into an AI Assistant (Notion & Confluence)