gitwtfhub

wtf is confluence2md-indexer?

gkoos/confluence2md-indexer — explained in plain English

Analysis updated 2026-05-18

2GoAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

A command-line tool that turns exported Confluence pages into a local, searchable SQLite database with keyword and meaning-based search.

Mindmap

mindmap
  root((confluence2md-indexer))
    What it does
      Indexes markdown exports
      Builds SQLite database
      Stores embeddings
    Tech stack
      Go
      SQLite
    Use cases
      Offline wiki search
      AI assistant queries
      Hybrid search
    Audience
      Developers
      Confluence exporters

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Search through an exported Confluence wiki offline, without needing internet access.

REASON 2

Build a local knowledge base an AI assistant can query through the companion MCP tool.

REASON 3

Run keyword, meaning-based, or combined search over a large set of exported documents.

REASON 4

Keep a search index updated incrementally as exported documents change.

What's in the stack?

GoSQLite

How it stacks up

gkoos/confluence2md-indexeranomalroil/1keyanshuman852/dasan-router-cli
Stars222
LanguageGoGoGo
Last pushed2019-05-17
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity3/53/53/5
Audiencedeveloperops devopsops devops

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires an existing confluence2md export folder and Go 1.25+ if building from source.

MIT license: use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

Wtf does this do

confluence2md-indexer takes documents exported from Confluence, a workplace wiki tool, and turns them into a searchable local database on your own computer. It is the second step in a three-part pipeline: first confluence2md exports Confluence pages to markdown files, then this tool builds a search index from those files, and a separate tool called confluence2md-mcp lets AI assistants query that index. Once you point it at an export folder, it reads the markdown pages, breaks them into smaller chunks of text, and stores those chunks in a single SQLite database file along with their embeddings, which are numeric representations used for finding similar meaning rather than just matching exact words. From the command line you can then search that database three ways: plain keyword search, meaning-based vector search, or a hybrid of both, with results returned as readable text or as structured JSON. The tool re-indexes only what changed since the last run by default, though a full rebuild is available when needed, and it removes records for documents that no longer exist in the source export. It also exposes a Go API so another program, such as the MCP connector, can query the index directly without running the command-line tool as a separate process. The README notes this is built for local, single-developer use rather than serving many users at once, and includes guidance for estimating how large the resulting database will get based on how much markdown text you feed it. Using it requires Go 1.25 or newer to build from source, though pre-built binaries are also offered on the project's releases page. It is licensed under MIT.

Yoink these prompts

Prompt 1
Show me the command to index a confluence2md export folder with confluence2md-indexer.
Prompt 2
Explain the difference between lexical, vector, and hybrid search modes in this tool.
Prompt 3
How do I estimate how large my resulting SQLite database will be before indexing?
Prompt 4
Walk me through connecting confluence2md-indexer to confluence2md-mcp so an AI client can query it.

Frequently asked questions

wtf is confluence2md-indexer?

A command-line tool that turns exported Confluence pages into a local, searchable SQLite database with keyword and meaning-based search.

What language is confluence2md-indexer written in?

Mainly Go. The stack also includes Go, SQLite.

What license does confluence2md-indexer use?

MIT license: use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

How hard is confluence2md-indexer to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is confluence2md-indexer for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.