Docs

Articles

Write and manage articles in Boki

Articles

Articles are the content you create. You write them — Boki helps with research and review.

Creating an article

From the header Create menu

The fastest way to start an article:

  1. Open the Create menu in the workspace header
  2. Select Articles
  3. Enter a title
  4. Start writing

From a brief

The recommended workflow:

  1. Open your brief
  2. Click Create article
  3. The editor opens with brief context

From the sidebar

  1. Go to Create → Articles in the sidebar
  2. Click Create article
  3. Enter a title
  4. Start writing

The editor

Boki's editor supports:

  • Rich text: Formatting, headings, lists
  • Markdown: Write in markdown syntax
  • MDX: Include React components
  • Real-time collaboration: Multiple writers simultaneously
  • Version history: See and restore previous versions
  • Comments: Leave notes for collaborators

See Editor for full details.

Writing with Boki

While writing, you can:

  • Ask Boki inline: Highlight text, click the sparkle
  • Request reviews: Technical or marketer review
  • Check visibility: Score against a question (beta)
  • Get suggestions: Ask for rewrites, expansions, or simplifications

You remain the author. Boki reviews, assists, and — when your article is linked to an SEO brief — can draft or revise content using live SEO context.

SEO-aware drafting

When your article is linked to a brief with SEO optimization, Boki can write using the live SEO context from that brief.

How it works:

  1. Link your article to a brief that has SEO optimization (see Create with SEO)
  2. Ask Boki to draft or revise content
  3. Boki reads the target keyword, format, and research from the Optimize panel
  4. The draft targets those keywords and covers the topics the Optimize panel tracks
  5. Your SEO score updates to reflect the new content

This closes the gap between optimization and drafting. Instead of writing first and optimizing after, you get a draft that already targets your keyword, so you spend fewer revision cycles getting a piece SEO-ready.

When to use it:

  • You have a brief with completed SEO analysis
  • You want a first draft that targets your keywords
  • You're revising an existing article to improve SEO score

SEO Optimize panel

The Optimize panel shows your article's SEO analysis and the evidence behind every score. Access it from the sidebar when editing an article linked to a brief with SEO optimization.

AI search evidence

The panel shows how AI search engines see your content:

  • Topics cited: Which topics AI search engines cite when answering queries in your space
  • Source counts: How many sources back each topic
  • AI surfaces: Which AI platforms (Google AI, ChatGPT, Perplexity, etc.) surface each topic
  • Source links: Direct links to the sources AI engines reference

This visibility helps you understand what AI search engines value, so you can align your content with what they cite.

Score explanations

Each audit metric includes an explanation of why it received its score. Instead of seeing a number alone, you see the reasoning — what the analysis found, what's strong, and what could improve.

The panel rates the strength of your links. This helps you identify weak links that should be replaced and strong links worth keeping.

Content-consistency checks

Before you publish, the panel reviews your article for internal alignment — checking that your content is consistent throughout and doesn't contradict itself.

Additional SEO panel improvements

The Optimize panel also includes:

  • Google AI evidence: Clearer display of what Google AI cites, including eligible domains and recommended actions
  • Competitor data freshness: A flag when competitor data may be outdated, so you know when to refresh before trusting a score
  • Reliable layout: Consistent display across tablet and desktop views

Article views

Articles support multiple views:

Articles list view

Table: List view with title, status, date, word count. The Access column shows and lets you edit who can view each article.

Board: Kanban by status (Draft, Review, Published).

Calendar: Articles on publish dates.

Article status

StatusMeaning
DraftWork in progress
ReviewReady for review
ApprovedPassed review, ready to publish
PublishedLive
ArchivedNo longer active

Public visibility

When publishing an article, the visibility dropdown includes an option:

Allow search engines to index: Check this to let search engines crawl and index the published article. Uncheck to add a noindex directive.

Exporting articles

Export your articles in multiple formats:

  • Markdown (.md)
  • MDX (.mdx)
  • PDF (.pdf)
  • Word (.docx)

To export:

  1. Open the article
  2. Click the menu (three dots)
  3. Select Export
  4. Choose format

Managing articles

Edit an article

Open the article to edit. Changes save automatically.

Delete an article

  1. Open the article
  2. Click the menu (three dots)
  3. Select Delete

Duplicate an article

  1. Open the article
  2. Click the menu (three dots)
  3. Select Duplicate

Creates a copy with "Copy of" prefix.