Files Content

Files & Content

Learn how to create and manage documentation files in Contextium.

Creating Files

Quick Create

  1. Click Add File in the sidebar or dashboard
  2. Select a project (optional)
  3. Enter a file name
  4. Start writing
  5. Click Save or use Cmd + S / Ctrl + S

Create in Project

  1. Navigate to a project
  2. Click New File
  3. Enter file name
  4. Write your content
  5. Save

Create in Folder

  1. Navigate to a folder
  2. Click New File
  3. File is automatically created in that folder

Converting Documents

Contextium can convert Word documents and PDFs into markdown format, making it easy to migrate existing documentation into your workspace.

Supported Formats

The document converter supports:

  • Microsoft Word - .docx and .doc files
  • PDF - .pdf files (text-based PDFs only)

Maximum file size: 50MB

Note: The document converter is perfect for migrating existing documentation, knowledge bases, or technical guides into Contextium. For best results, use documents with standard formatting and minimal custom styling.

How to Convert a Document

  1. Navigate to a project
  2. Click Convert Document button
  3. Select a Word document or PDF from your computer
  4. Review the conversion preview (if warnings are shown)
  5. Click Got it to complete the conversion

The converted file will appear in your project as a new markdown file.

What Gets Converted

The converter will preserve:

  • Text content - All paragraph text and headings
  • Heading hierarchy - H1, H2, H3, etc.
  • Bold and italic - Basic text formatting
  • Lists - Bulleted and numbered lists
  • Links - Hyperlinks within the document
  • Tables - Table structure and content
  • Code blocks - Formatted code sections

Conversion Limitations

Some elements cannot be converted automatically:

  • Images - Embedded images are not imported
  • Comments - Word comments and tracked changes
  • Custom fonts - Font families and advanced styling
  • Colors and spacing - Custom colors and precise spacing
  • Edit history - Previous revisions from the original document
  • Headers/Footers - Page headers and footers
  • Complex formatting - Advanced Word styles and layouts

After Conversion

Once converted, you can:

  • Edit the markdown content
  • Add images manually
  • Apply tags and organize into folders
  • Share with team members
  • Track changes with version control

Tip: Keep your original document as a reference for any content that wasn't converted, such as images or complex formatting.

Pro Tip: For documents with many images, consider uploading images separately and adding them to your markdown files using standard markdown image syntax.

Best Practices for Conversion

For best results when converting documents:

  1. Simplify before converting - Remove complex styling from the source document
  2. Use standard headings - Use Word's built-in heading styles (H1, H2, etc.)
  3. Save images separately - Extract images before conversion and add them manually
  4. Review after conversion - Always check the converted markdown for accuracy
  5. Test with a sample - Try converting a small document first to understand what will be preserved

The File Editor

Editor Interface

The editor includes:

  • Title Bar - File name and quick actions
  • Content Area - Markdown editor
  • Toolbar - Formatting options
  • Save Status - Auto-save indicator
  • Version Info - Current version number

Markdown Support

Contextium supports standard Markdown formatting:

# Heading 1 ## Heading 2 ### Heading 3 **Bold text** *Italic text* ~~Strikethrough~~ - Bullet list - Another item 1. Numbered list 2. Another item [Link text](https://example.com) ![Image alt text](image-url) `inline code` ​```javascript // Code block function example() { return true; } ​``` > Blockquote | Table | Header | |-------|--------| | Cell | Cell |

Auto-Save

Files auto-save every 30 seconds when you're actively editing. You can also:

  • Press Cmd + S / Ctrl + S to save manually
  • Click Save in the toolbar
  • Navigate away (triggers auto-save)

File Operations

Rename a File

  1. Open the file
  2. Click the file name in the title bar
  3. Edit the name
  4. Press Enter

Move a File

  1. Open the file
  2. Click File Settings (⋯)
  3. Select Move to Project or Move to Folder
  4. Choose destination
  5. Click Move

Duplicate a File

  1. Open the file
  2. Click File Settings (⋯)
  3. Select Duplicate
  4. Edit the name
  5. Click Duplicate

Creates a copy with "-copy" appended to the name.

Delete a File

  1. Open the file
  2. Click File Settings (⋯)
  3. Select Delete
  4. Confirm deletion

Deleted files move to trash and can be restored for 30 days.

File Metadata

View file information in the file sidebar:

  • Created By - Original author
  • Created Date - When file was created
  • Last Updated - Most recent modification
  • Updated By - Who made the last change
  • Version Count - Number of versions
  • File Path - Location in workspace
  • Tags - Applied tags

Working with Multiple Files

Recent Files

Access recently viewed files from the dashboard or with Cmd + K / Ctrl + K quick switcher.

File Browser

View all workspace files:

  1. Navigate to All Files in the sidebar
  2. See complete file list
  3. Filter by project, folder, or tags
  4. Sort by name, date, or update time

Search Files

Use the search bar to find files by:

  • File name
  • File path
  • Content (Business plan with Elasticsearch)
  • Tags

File Limits

File limits vary by plan:

  • Starter - 25 files
  • Professional - Unlimited files
  • Business - Unlimited files
  • Enterprise - Unlimited files

Individual file size limit: 5MB per file

Best Practices

Naming Files

Use descriptive, searchable names:

  • ✅ "authentication-api.md"
  • ✅ "User Onboarding Guide.md"
  • ✅ "Database Migration Steps.md"
  • ❌ "doc1.md"
  • ❌ "untitled.md"
  • ❌ "notes.md"

Structuring Content

  • Use clear heading hierarchy (H1 → H2 → H3)
  • Include a table of contents for long docs
  • Break up large walls of text
  • Use code blocks for technical content
  • Add links to related documentation

Keeping Files Focused

  • One topic per file
  • Split large files into multiple documents
  • Link related files together
  • Use folders to group related files

Keyboard Shortcuts

Common file editor shortcuts:

  • Cmd/Ctrl + S - Save file
  • Cmd/Ctrl + K - Quick file switcher
  • Cmd/Ctrl + B - Bold selected text
  • Cmd/Ctrl + I - Italic selected text
  • Cmd/Ctrl + / - Show all shortcuts

Next Steps


Documentation last updated: February 2026