Images

Keep images local, portable, and export-aware.

MarkStudio Pro works best when Markdown documents reference images relative to the document or selected working directory.

Markdown image syntax

![Alt text](images/diagram.png)
![Architecture overview](./assets/architecture.png)

Use meaningful alt text. It helps readers understand the document when an image cannot load and improves exported accessibility.

Relative paths

Relative paths are easier to move with the document. If you open a Markdown file from a folder, keep related images under that folder or a nearby assets directory.

Use Ctrl+Shift+D to set the working directory when a document uses many relative links or images.

Sizing

The image dialog can help insert Markdown with width and height intent. Prefer setting width only when you want the app to preserve the image aspect ratio.

Export behavior

  • HTML: keeps preview behavior and can package local images for portable output.
  • PDF: renders images through the print/export preview path.
  • Word: inserts supported images into the document where possible.
  • Missing image: export paths show a warning or fallback instead of silently hiding the problem.

Safety notes

Avoid remote tracking images in documents you distribute. Keep assets local and use filenames that make sense in source control or shared folders.

For diagram content generated from text, consider Mermaid diagrams so the diagram source remains inside the Markdown file.