[PR #82] [CLOSED] feat(bookstack): use native markdown export for pages #102

New issue

Closed

opened 2026-10-18 21:14:22 +00:00 by bsakaguchi · 0 comments

bsakaguchi commented

2026-10-18 21:14:22 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/open-webui/oikb/pull/82
Author: @hexsm
Created: 7/15/2026
Status: ❌ Closed

Base: main ← Head: feature/bookstack-markdown-export

📝 Commits (1)

0f7d4c4 feat: use markdown export for BookStack pages

📊 Changes

2 files changed (+11 additions, -7 deletions)

View changed files

📝 CHANGELOG.md (+6 -0)
📝 src/oikb/connectors/bookstack.py (+5 -7)

📄 Description

Summary

Switches the BookStack connector from plain text output to BookStack's native Markdown page export.

BookStack synced pages now use .md files backed by:

GET /api/pages/{id}/export/markdown

Why

The connector previously fetched page HTML and stripped tags with a simple regex before uploading .txt files. This lost useful document structure such as headings, lists, links, code blocks, and tables.

BookStack provides a native Markdown export endpoint for pages, which preserves more structure and is better suited for Knowledge Base ingestion.

Changes

Use .md filenames for BookStack synced pages.
Fetch page content from BookStack's native Markdown export endpoint.
Remove the manual HTML-to-text regex conversion.
Document the behavior change in CHANGELOG.md.

Validation

python3 -m compileall src/oikb/connectors/bookstack.py
Tested against a running BookStack/oikb container by patching the connector in-place and confirming Markdown export sync works.

Notes

Existing BookStack .txt entries may be replaced by .md entries on the next sync because the exported file extension changes.

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/open-webui/oikb/pull/82 **Author:** [@hexsm](https://github.com/hexsm) **Created:** 7/15/2026 **Status:** ❌ Closed **Base:** `main` ← **Head:** `feature/bookstack-markdown-export` --- ### 📝 Commits (1) - [`0f7d4c4`](https://github.com/open-webui/oikb/commit/0f7d4c4efa1ded9fe71abe447925cd86cbdd1c5f) feat: use markdown export for BookStack pages ### 📊 Changes **2 files changed** (+11 additions, -7 deletions) <details> <summary>View changed files</summary> 📝 `CHANGELOG.md` (+6 -0) 📝 `src/oikb/connectors/bookstack.py` (+5 -7) </details> ### 📄 Description ## Summary Switches the BookStack connector from plain text output to BookStack's native Markdown page export. BookStack synced pages now use `.md` files backed by: `GET /api/pages/{id}/export/markdown` ## Why The connector previously fetched page HTML and stripped tags with a simple regex before uploading `.txt` files. This lost useful document structure such as headings, lists, links, code blocks, and tables. BookStack provides a native Markdown export endpoint for pages, which preserves more structure and is better suited for Knowledge Base ingestion. ## Changes - Use `.md` filenames for BookStack synced pages. - Fetch page content from BookStack's native Markdown export endpoint. - Remove the manual HTML-to-text regex conversion. - Document the behavior change in `CHANGELOG.md`. ## Validation - `python3 -m compileall src/oikb/connectors/bookstack.py` - Tested against a running BookStack/oikb container by patching the connector in-place and confirming Markdown export sync works. ## Notes Existing BookStack `.txt` entries may be replaced by `.md` entries on the next sync because the exported file extension changes. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi

2026-10-18 21:14:22 +00:00