DocsWriting Studio › Embedding images / PDFs / link previews

Embedding images / PDFs / link previews

Last updated May 29, 2026 · 4 min read

Writing isn't only words — character concept art, maps, reference PDFs are common in notes. Slima supports four embed types.

1 · Images

The simplest. Three ways to insert:

Method How
Drag Drop image from your file manager into the editor
Toolbar Image icon → upload
Markdown Type ![Slima Writing Studio editor: left file tree (Chapters / Notes) / centre editor / right Notes panel](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsiZGF0YSI6MTE4LCJwdXIiOiJibG9iX2lkIn19--2017c9c527cea624886c5fb351d5d06394f1c22b/en-editor-layout.png) directly

Formats: jpg / png / gif. Limit 10 MB / image.

Alt text

  • Alt text: required — the AI Coach uses it when "seeing" the image

2 · PDFs

![](path/to/file.pdf) or drag.

How they show:

  • Embedded viewer (prev / next page + zoom)
  • Pages render as images, so text can't be selected or annotated
  • Text content is read by the AI Coach (text PDFs, not scanned)

Limit 10 MB / file. (The 50 MB limit applies only to the separate path that imports a PDF by converting it to plain text.)


3 · Link previews

Type an external link [title](https://...), hover and Slima auto-fetches the Open Graph preview (thumbnail + title + description).

Great for citing online sources:

Reference: [Lighthouse keepers](https://en.wikipedia.org/wiki/Lighthouse_keeper)

Previews are cached — even offline you'll see the last fetched preview.


4 · Internal links

Slima has no [[ ]] wikilink syntax — its approach is more automatic: type a character, location (or other entity) name right in the text and Slima gives it a dotted underline once detected.

  • Ctrl / Cmd-click → jump to that entity's file
  • Rename the entity and detection keeps up

See: Entity tracking and detail


Where to put media

Inside Notes:

Notes
├── Characters
│   ├── Protagonist.md
│   └── Protagonist.jpg
├── Maps
│   └── Lighthouse location.png
└── Reference PDFs
    └── Marine ecology survey.pdf

Co-located with the text file → easy to find.


What happens on export

  • Export to EPUB / DOCX → images included
  • Export to Markdown → images as base64 or external links
  • Export to .slima backup → originals preserved

Related

Was this helpful?