Importing Markdown & HTML

Guidevera can import existing content from Markdown (.md) or HTML files, creating a new page for each import. Requires the Contributor role or higher. The feature must be enabled via enableImport in the application settings.

How to import

Open the import dialog from the sidebar toolbar. You can either:

• Upload a file — select a .md, .markdown, or .html file from your computer. The file extension determines the format automatically.
• Paste content — paste raw Markdown or HTML text directly into the text area and select the format.

Optionally provide a title. If left empty, the filename is used as the page title.

What gets imported

For Markdown, the following elements are converted to HTML: headings (# to ###), bold, italic, inline code, links, and unordered lists. The content is sanitized after conversion. For HTML, the content is sanitized directly.

Limits

• Maximum file size: 2 MB
• The imported page is created as inactive at the root level. Move and activate it after import.