Import code files #5104

New Issue

OVERLORD · 2026-02-05T09:40:33+03:00

OVERLORD commented

2026-02-05 09:40:33 +03:00

Originally created by @FaroJoaoFaro on GitHub (Jan 6, 2025).

Describe the feature you'd like

I would like the ability to upload coding files (e.g., PHP, Python, or JS files) directly into BookStack pages. Once uploaded, the files could be displayed in one of two ways:

As an icon with the file name that, when clicked, opens the file's content in a modal or separate viewer.
Automatically transformed into a code block (using the language syntax highlighting that already exists in BookStack).

Additionally, it would be beneficial to have features like:

Minimizable code blocks: So that large code blocks (e.g., 1000+ lines) don’t dominate the page.
Code previews in modals: Clicking on a file or block could show a modal or expandable viewer for better usability.

This would significantly improve documentation for projects where large code snippets or files need to be included without overwhelming the visual layout of the page.

Describe the benefits this would bring to existing BookStack users

This feature would bring the following benefits:

Improved readability: Large code snippets would no longer clutter pages, making documentation easier to read.
Better organization: Developers can upload and reference files directly in BookStack rather than pasting raw code blocks, which can be cumbersome.
Enhanced usability: Users can navigate and view file content on demand, either through modals or minimized blocks.
Efficiency in documentation: This feature supports a more structured approach for technical documentation involving large codebases.

These benefits apply broadly to any team or individual using BookStack to document software projects with embedded code.

Can the goal of this request already be achieved via other means?

No, not entirely. While you can manually paste code into a page as a code block, this is inefficient for handling larger code files and does not provide the features of file uploading, code previews, or minimizable blocks.

Have you searched for an existing open/closed issue?

I have searched for existing issues and none cover my fundamental request

How long have you been using BookStack?

Under 3 months

Additional context

No response

Originally created by @FaroJoaoFaro on GitHub (Jan 6, 2025). ### Describe the feature you'd like I would like the ability to upload coding files (e.g., PHP, Python, or JS files) directly into BookStack pages. Once uploaded, the files could be displayed in one of two ways: 1. As an icon with the file name that, when clicked, opens the file's content in a modal or separate viewer. 2. Automatically transformed into a code block (using the language syntax highlighting that already exists in BookStack). Additionally, it would be beneficial to have features like: - Minimizable code blocks: So that large code blocks (e.g., 1000+ lines) don’t dominate the page. - Code previews in modals: Clicking on a file or block could show a modal or expandable viewer for better usability. This would significantly improve documentation for projects where large code snippets or files need to be included without overwhelming the visual layout of the page. ### Describe the benefits this would bring to existing BookStack users This feature would bring the following benefits: - Improved readability: Large code snippets would no longer clutter pages, making documentation easier to read. - Better organization: Developers can upload and reference files directly in BookStack rather than pasting raw code blocks, which can be cumbersome. - Enhanced usability: Users can navigate and view file content on demand, either through modals or minimized blocks. - Efficiency in documentation: This feature supports a more structured approach for technical documentation involving large codebases. These benefits apply broadly to any team or individual using BookStack to document software projects with embedded code. ### Can the goal of this request already be achieved via other means? No, not entirely. While you can manually paste code into a page as a code block, this is inefficient for handling larger code files and does not provide the features of file uploading, code previews, or minimizable blocks. ### Have you searched for an existing open/closed issue? - [X] I have searched for existing issues and none cover my fundamental request ### How long have you been using BookStack? Under 3 months ### Additional context _No response_

OVERLORD added the 🔨 Feature Request label 2026-02-05 09:40:33 +03:00

Sign in to join this conversation.

Branches Tags

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: starred/BookStack#5104