Including images
You can include images by adding them to a text cell, using the appropriate Markdown syntax.

Example of adding images
There are several ways to do this:
- In a text cell, click theicon and select the file from your filesystem. The image will be uploaded to your workspace filesystem, and the required markdown syntax to display the image will be added where your cursor is.
- Copy and paste
- Copy the image on your computer
- On Windows, you can use
Ctrl
+C
for this. - On Mac, you can use
Cmd
+C
.
- Paste the image into a text cell in your notebook
- On Mac, you can use
Cmd
+V
. - On Windows, you can use
Ctrl
+V
for this.
- The image will be uploaded to your workspace filesystem, and the required markdown syntax to display the image will be added where your cursor is.
- Drag and drop the image on your computer into the text cell that you want to contain the image. The image will be uploaded to your workspace filesystem, and the required markdown syntax to display the image will be added where your cursor is.
- Manually upload the file and point to it in the text cell:
- Open the file browser in the left sidebar.
- Upload the image you want to include. The filename cannot contain spaces. If it does, change the filename using the rename functionality.
- In the text cell, add

(in this example, the filename of the image that is being included ismy_image.png
).
You can easily make screenshots and add them to your notebook:
- Take the screenshot and copy it to your clipboard.
- On Windows, you can use
Windows
+Shift
+S
for this. - On Mac, you can use
Cmd
+Ctrl
+Shift
+4
for this.
- Paste the screenshot into your text cell
- On Windows, you can use
Ctrl
+V
for this. - On Mac, you can use
Cmd
+V
for this.
The screenshot will be uploaded to your workspace filesystem, and the required markdown syntax to display the image will be added where your cursor is.
If you already have an image file in your workspace, and want to display that in your notebook, add

to a text cell. In this example, the filename of the image that is being included is my_image.png
. Note that the filename should not contain spaces for this to work!In a text cell, add the following text (in this example, the image is available on https://picsum.photos/200):

Using the
<img>
HTML element inside a text cell to include an image will work in the editor, but the image will not render correctly in a publication. This is a limitation we're planning to fix.Last modified 5mo ago