Including images

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

Include an image on your computer

There are several ways to do this:

  • 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 ![my image caption](my_image.png) (in this example, the filename of the image that is being included is my_image.png).

Include a screenshot from your clipboard

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.

Include an image that in your workspace

If you already have an image file in your workspace, and want to display that in your notebook, add ![my image caption](my_image.png) 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!

Include image from a URL

In a text cell, add the following text (in this example, the image is available on https://picsum.photos/200):

![a random image](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 updated