Render includes in markdown exports #5030

New Issue

OVERLORD · 2026-02-05T09:35:12+03:00

OVERLORD commented

2026-02-05 09:35:12 +03:00

Originally created by @JasonGehring on GitHub (Oct 29, 2024).

Describe the Bug

I am not sure if this is intended behavior, but using the API endpoint or the Export as Markdown function on a Page, will not include the content of an included page. It will come back as {{@123}}

Steps to Reproduce

Include a page with the {{@123}} functionality
Export the page as PDF to confirm the content is Included correctly
Export as Markdown to find the {{@123}} include tag

Expected Behaviour

I would have expected the Markdown to export the included Page, like pdf or plaintext do. Or at least to have the option to include it.

Screenshots or Additional Context

No response

Browser Details

No response

Exact BookStack Version

v24.10

Originally created by @JasonGehring on GitHub (Oct 29, 2024). ### Describe the Bug I am not sure if this is intended behavior, but using the API endpoint or the Export as Markdown function on a Page, will not include the content of an included page. It will come back as {{@123}} ### Steps to Reproduce 1. Include a page with the {{@123}} functionality 2. Export the page as PDF to confirm the content is Included correctly 3. Export as Markdown to find the {{@123}} include tag ### Expected Behaviour I would have expected the Markdown to export the included Page, like pdf or plaintext do. Or at least to have the option to include it. ### Screenshots or Additional Context _No response_ ### Browser Details _No response_ ### Exact BookStack Version v24.10

OVERLORD added the 🔨 Feature Request 🚚 Export System labels 2026-02-05 09:35:12 +03:00

OVERLORD commented

2026-02-05 09:35:14 +03:00

@ssddanbrown commented on GitHub (Oct 30, 2024):

Hi @JasonGehring,
Yeah, includes won't be handled with markdown, as no parts of the system consider includes when it comes to markdown content, so would need specific added handling.

I've updated this to an export feature request rather than a bug since it's more of a bug relative to expectations rather than a bug in existing functionality.

@ssddanbrown commented on GitHub (Oct 30, 2024): Hi @JasonGehring, Yeah, includes won't be handled with markdown, as no parts of the system consider includes when it comes to markdown content, so would need specific added handling. I've updated this to an export feature request rather than a bug since it's more of a bug relative to expectations rather than a bug in existing functionality.

OVERLORD referenced this issue

2026-02-05 10:32:18 +03:00

[PR #5030] [CLOSED] Fix TypeError in GalleryImageController by Ensuring Default Value for uploadedTo #6437

Sign in to join this conversation.

Branches Tags

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: starred/BookStack#5030