Media & Import

Media Browser

The Media browser lets you view and manage all images you've uploaded through the document editor. Navigate to Media in the sidebar.

[screenshot: media browser showing a grid of uploaded images]

Storage Usage

The top-right of the Media page shows your current storage usage (e.g. "12.5 / 100 MB used"). Your storage limit is set by the administrator.

Browsing Media

Uploaded images are displayed in a grid. Each media card shows:

A thumbnail preview of the image
The original filename
File size, dimensions (width x height), and file format
Upload date (relative, e.g. "3 days ago")

Click on any thumbnail to open it in a lightbox — a full-size overlay view. Press Escape or click outside the image to close it.

[screenshot: lightbox view showing a full-size image]

Copying the Markdown Tag

Each media item has a Copy button. Click it to copy the Markdown image tag (e.g. ![image](url)) to your clipboard. You can then paste this into any document's content to embed the image.

Deleting Media

Click Delete on any media item. You'll be asked to confirm before the image is permanently removed. Note that deleting media does not automatically remove references to it from your documents — you'll need to clean up any Markdown image tags manually.

Uploading Images

Images are uploaded from within the document editor, not from the Media browser. In the editor toolbar, click the image button, select a file (JPEG, PNG, GIF, or WebP), and the image will be uploaded and inserted at your cursor position.

[screenshot: image upload button in the editor toolbar]

Importing Documents

Kherpi can import documents from Markdown files. Navigate to Documents > Import (or click the Import button on the Documents page).

[screenshot: import page with upload form]

Note: Import access is controlled by the administrator. If you see a message saying "You do not have permission to import documents", contact your administrator.

Supported Formats

Single Markdown file (.md) — imports one document
ZIP archive (.zip) — imports multiple .md files at once (max 50 MB)

How to Import

Click Choose File and select your .md file or .zip archive
Click Import
Wait for the import to complete — a results table will show which files were imported successfully and any that failed

[screenshot: import results table showing imported files with success/failure status]

YAML Front Matter

Each Markdown file can include optional YAML front matter at the top of the file to set document metadata. All fields are optional.

---
title: My Document
type: note                  # slug or name (case-insensitive)
status: draft               # draft | published | archived
is_public: false
is_nsfw: false
labels:                     # list or comma-separated string
  - work
  - ideas
folder: projects            # slug or name (case-insensitive)
properties:                 # explicit properties block
  due_date: 2026-03-01
---

# Markdown content starts here

Fallback Behaviour

Field	Fallback
title	Falls back to the filename
type	Falls back to your default document type
status	Falls back to `draft`
folder	Imported without folder if not found
invalid YAML	The entire file is imported as plain content

Custom Properties in Front Matter

If the resolved document type has custom properties defined, any matching keys in the front matter (either at the top level or inside a properties: block) will be automatically set on the imported document.

Warnings

The import results may include warnings for individual files — for example, if a specified folder or document type wasn't found and a fallback was used. Successfully imported documents include a link to open them directly in the editor.

A collapsible Front matter reference section is available at the bottom of the import page for quick reference.

[screenshot: front matter reference section expanded]

05-media-and-import