Image Management

MerDoc provides a centralized image management system. Upload images once and reuse them across multiple documents from your media library.

1. Click "New Document" and select "Image" as the document type
2. Click "Choose File" or drag and drop an image
3. Enter a title for your image
4. Click "Upload" to save the image

Alternatively, you can upload images directly from the markdown editor toolbar when creating or editing documents.

All uploaded images are stored in your media library, accessible from the images page. The media library shows:

• Image thumbnails for quick preview
• Image filename and title
• File size and dimensions
• Upload date
• Documents that use each image

You can view images in grid or list view, and search/filter by filename.

MerDoc includes a built-in image editor that lets you edit images directly in the browser without external tools. To edit an image:

1. Open the image from your media library
2. Click "Edit" in the image actions menu
3. Use the editing tools to modify the image
4. Click "Save" to apply your changes

The image editor provides the following tools:

• Crop: Select an area of the image to crop. Click and drag to define the crop area, then click "Apply Crop"
• Resize: Resize the image to specific dimensions. You can maintain the aspect ratio or set custom dimensions
• Rotate: Rotate the image 90 degrees clockwise or counterclockwise. Click the rotate buttons to rotate left or right

All edits are applied before saving, and you can preview changes in real-time. Original images are preserved, so you can always revert changes.

Once uploaded, you can use images in any document:

• From Editor Toolbar: Click the image icon in the markdown editor toolbar to open the media library and insert an image
• Markdown Syntax: Use standard markdown image syntax: ![alt text](/images/[imageId])
• Direct Links: Images are accessible via their URL and can be embedded in any document

MerDoc automatically optimizes uploaded images:

• Images are stored efficiently in cloud storage
• Dimensions are tracked for responsive display
• File sizes are optimized for fast loading
• Images are served via a CDN for global performance

• Use descriptive titles for images to make them easy to find
• Upload images in appropriate formats (JPG for photos, PNG for graphics)
• Use the media library to reuse images across multiple documents
• Edit images before using them in documents to ensure optimal sizing
• Keep image file sizes reasonable for faster loading
• Use the crop tool to focus on important parts of images