Skip to main content

Images

Scribe supports JPG / PNG images in manuscripts. Normal images are not a Pro-only syntax: Free, Plus, and Pro projects can insert images, adjust image width, and switch an image to full-page display. Full-page image backgrounds belong to page templates and require Pro; see Advanced → Page templates.

Inserting an image​

Click Insert image in the editor toolbar, then choose:

  • Import from disk… — choose a .jpg, .jpeg, or .png image from your computer. Scribe copies it into the project assets and inserts it at the current cursor position.
  • Choose from project library… — choose an image already imported into the current project.

Standard Markdown image references already in the document continue to display, for example:

![alt text](./assets/images/photo.jpg)

The alt text is optional but recommended; it is included in the EPUB for screen readers.

Where the file lives​

Every project has its own assets/images/ image resources. Scribe copies images imported from disk there so the manuscript stays self-contained — move the whole project folder to another computer and the images move with it.

If you remove an image reference from the document, the stored copy is not automatically deleted. An orphaned image is harmless and does not appear in exports; remove the file manually if you want to reclaim the space.

Display mode and size​

Click an image in the editor to open the image toolbar. Common settings include:

  • Inline — the image appears as part of the body text and can use a width percentage.
  • Full-page — the image occupies its own page, useful for chapter illustrations, dividers, and photo pages.
  • Fit — in Full-page mode, choose one of three fitting modes:
    • Bleed: extend into the page bleed area, suitable for print bleed art.
    • Cover: fill the page and crop image edges when needed.
    • Contain: show the whole image and leave empty margins when needed.

These settings are saved with the document. Older or external editors see the standard Markdown image reference; Scribe keeps the richer image-display settings with the document or Project.

How images flow between targets​

The same image reference is laid out differently depending on which preview mode you are in:

  • Image preview / image export — Inline images appear with the body text; Full-page images occupy their own page and use the selected fit mode.
  • E-book preview / EPUB export — images flow with the text. Their displayed width is limited by the inline width setting and the available reading area.
  • Print preview / PDF export — Inline images are laid out at their body-text position; Full-page images occupy their own page, with fitting controlled by the image toolbar.

If you want a specific image to live at the start of a page, introduce a <!-- page-break --> comment in the Markdown right before it.

Supported formats​

  • PNG — preferred for screenshots, transparent images, line art.
  • JPEG / JPG — preferred for photographs.

For print, use source images that meet your print provider's current resolution requirements at the intended printed size. EPUB uses the source image while the reading layout constrains its displayed width. Check every export in the target viewer before publishing.