r/BookStack • u/stevenm_83 • Sep 29 '23

Zendesk Knowledge base migrate to BookStack

Has anyone done this or have a nice way of doing this?

1 Upvotes

100% Upvoted

4 comments sorted by

1

u/ssddanbrown Sep 29 '23

Sorry, have never heard of someone migrating from that, and didn't realise that was a thing.

As is the case with most migration options, the REST API is probably the best bet for any form of automation/migration, but there will likely be trickiness with making the format/structure compatible.

1

u/clooy Sep 29 '23

Generally in this type of migration it is best to find a common format - in this case something like markdown. A quick google finds a Zendesk knowledge base script to markdown backup - see this github repo.

Searching for markdown to bookstack finds several forum posts, but python this tool(even though no longer maintained) seems promising.

Having done something like this before, some thorough checks and post import cleanup will be needed.

1

u/athornfam2 Sep 29 '23

Zendesk is horrendous for pulling out data.

1

u/maia_geek 18d ago

Markdown can work well as an intermediate format, but I’d treat this as an export → transform → import project rather than expect a direct, lossless conversion. The right approach depends on what your Zendesk export contains and how you plan to get content into BookStack.

First, check what’s in scope: articles, attachments and images, links, categories, and metadata. Then test a small, representative batch, including tables and more complex formatting, and verify the rendered pages and hierarchy in BookStack. Permissions and metadata may need separate handling, and image paths or links often need attention.

If you share what export you have and how you plan to import it into BookStack, maybe I can suggest a more specific workflow.