Welcome! This guide covers everything you need to know about using the file browser and document server.
Your experience depends on how you access the server:
You can sign in using one of the available methods shown on the login page:
Your administrator determines which sign-in methods are available. If you only see a message about an API key, contact your administrator for access.
After signing in, you'll be redirected to the page you were originally trying to reach.
Insiders have full authenticated access to the server. After signing in, you can browse files, search documents, create share links, and export content.
The file browser is your home screen. Navigate through directories by clicking folder names. Click any file to view its contents. Use the breadcrumb trail in the header to navigate back up.
| Type | Extensions | Rendering |
|---|---|---|
| Markdown | .md |
Full formatting, table of contents, embedded diagrams |
| Code | .ts, .js, .py, .json, etc. |
Syntax highlighting with line numbers, copy and word-wrap toggle |
| CSV | .csv |
Formatted tables |
| SVG | .svg |
Interactive pan-and-zoom viewer |
| Mermaid diagrams | .mmd |
Rendered flowcharts, sequence diagrams, Gantt charts, etc. |
| PlantUML diagrams | .puml, .plantuml, .pu |
Rendered UML, architecture, and component diagrams |
| Images | .png, .jpg, .gif, .webp |
Displayed inline |
| Other files | — | Available for download |
For files that support rendering (Markdown, CSV, SVG, diagrams), you can toggle between:
All code blocks (in both rendered and raw views) display a hover toolbar with two controls:
.txt, .log, .csv) default to wrap on; code files default to wrap off.Use the tab bar below the header to switch views.
Markdown files with headings display a table of contents sidebar. On mobile, tap the TOC button in the tab bar to toggle it. Click any heading in the TOC to scroll directly to that section.
Adjust the reading width of rendered Markdown using the width toggle in the tab bar. Three settings are available: narrow, medium, and wide.
Diagrams can appear as standalone files or embedded in Markdown documents.
Standalone diagrams (.mmd, .puml) are rendered with an interactive viewer that supports pan and zoom.
Embedded diagrams are written in fenced code blocks within Markdown files:
```mermaid
graph TD
A[Start] --> B[End]
```
```plantuml
@startuml
Alice -> Bob: Hello
@enduml
```
Both Mermaid and PlantUML are supported. Embedded diagrams are rendered inline alongside the surrounding text.
Use the search button in the header (or press Ctrl+K / Cmd+K) to search across all indexed documents. Results are ranked by relevance and show matching text snippets.
Search supports filters for domains, authors, and other metadata when available. Search is only available to insiders.
Insiders can create links to share files or directories with outsiders — people who don't have an account.
Share links are cryptographically signed and cannot be guessed. Each link is scoped to the specific path and sharing options you selected.
Your administrator may configure an outsider policy that restricts which paths can be shared externally. If a path is blocked by policy, the share dialog will indicate this.
Insiders can edit Markdown and text files directly in the browser:
Ctrl+Enter to save, or click Cancel to discard.Undo/redo buttons appear in the tab bar after edits are saved.
Your access key is used to generate share links. If you need to invalidate all your existing share links (e.g., if a link was shared with the wrong person), you can rotate your key from the account menu.
⚠️ Key rotation is permanent and cannot be undone. All share links you've previously created will stop working.
Outsiders access the server through a share link created by an insider. No sign-in is required.
Share links may have an expiry date set by the insider who created them. Expired links will no longer grant access. If you need continued access, ask the person who shared the link to create a new one.
Click the download icon in the header to access export options. Available formats depend on the file type:
| Source | Available Exports |
|---|---|
| Markdown files | PDF, DOCX, Raw download |
| Directories | ZIP archive, Tar archive |
| Diagrams (Mermaid, PlantUML) | SVG, PNG |
| Any file | Raw download |
Both insiders and outsiders can download and export content they have access to.
| Shortcut | Action |
|---|---|
Ctrl+K / Cmd+K |
Open search (insiders only) |
Ctrl+Enter |
Save when editing |
If you need help with access, permissions, or configuration, contact your administrator or your AI assistant. Your assistant can help with tasks like setting up integrations, managing user access, and troubleshooting.
These guides are written for server administrators but may be useful as reference: