Images

Inserting images

• Paste an image, or drag one from Finder, Explorer or a browser.
• Type ![alt](path/to/image.png).
• Choose Format ▸ Image ▸ Insert Local Images…, or Insert Image (Mod+Shift+I).
• Right-click and choose Insert Media… for images, video and audio.

Where images go

Settings ▸ Image ▸ Image Action decides what happens when you insert an image:

• No special action (default) refers to the image where it is.
• Copy image to folder copies it, to ./assets unless you choose another folder.
• Upload image sends it to your uploader.
• Convert to TextBundle turns the document into a TextBundle, with its images inside.

Apply Above Action to Local Images (on) and Online Images (off) choose which images that covers. Ask for File Name When Pasting lets you name a pasted image.

A document can override the folder in its front matter with typora-copy-images-to; Format ▸ Image ▸ When Insert Local Image ▸ Copy Image File to Folder… writes it for you. Paths may use ${filename}, which becomes the document's name:

---
typora-copy-images-to: ./images/${filename}
---

Inserted Image Syntax sets Markdown ![]() or HTML <img>, and whether alt text is the file name or empty. Image Path covers Prefer Relative Paths (on), Add ./ for Relative Paths (off) and Escape Image URLs (off).

Root path

typora-root-url sets the folder that paths beginning with / resolve against, which helps with static site generators. Format ▸ Image ▸ Use Image Root Path… writes it.

Resizing images

Choose a size in Format ▸ Image ▸ Zoom Image, or in the context menu: 25% to 200%. Typora rewrites the image as HTML:

<img src="reef.png" style="zoom: 50%;" />

100% removes the zoom. You can also write width and height yourself on an <img>. Images can't be resized by dragging.

The image toolbar

Hover an image for Source, Edit and Expand. Edit opens its alt text, path and title, along with Open Image Location, Copy Image, Copy Path and Delete Image. Expand opens the image viewer.

Managing images

Format ▸ Image works on one image or all of them:

• Copy Image to…, Rename or Move Image to…, Upload Image.
• Copy All Images to…, Move All Images to…, Upload All Local Images.
• Switch Image Syntax between Markdown and HTML.
• Delete Image File deletes the file as well as the reference.
• Reload All Images refreshes them after a change on disk.
• Clean Up Unused Images… finds files in the assets folder that nothing refers to.

When you rename a document, its assets folder follows.

Uploading images

Choose a service in Settings ▸ Image ▸ Image Upload Setting ▸ Image Uploader:

Uploader	Platforms
PicGo (app)	All
PicList	All
Custom Command	All
uPic, Picsee	macOS
More from Extensions…	iPic and others from the extension store

Test Uploader checks the setup.

Custom Command runs your command with the image paths appended, and reads the resulting URLs from the end of its output. For the PicGo-Core command line, use picgo u.

Upload one image with Format ▸ Image ▸ Upload Image, or all of them with Upload All Local Images. To upload on insert, set Image Action to Upload image, or When Insert Local Image ▸ Upload Image. typora-copy-images-to: upload does it for one document once Allow Upload from YAML Settings is on.