I am starting to depend heavily on the IPython notebook app to develop and document algorithms. It is awesome; but there is something that seems like it should be possible, but I can’t figure out how to do it:

I would like to insert a local image into my (local) IPython notebook markdown to aid in documenting an algorithm. I know enough to add something like <img src="https://stackoverflow.com/questions/10628262/image.png"> to the markdown, but that is about as far as my knowledge goes. I assume I could put the image in the directory represented by (or some subdirectory) to be able to access it, but I can’t figure out where that directory is. (I’m working on a mac.) So, is it possible to do what I’m trying to do without too much trouble?

Most of the answers given so far go in the wrong direction, suggesting to load additional libraries and use the code instead of markup. In Ipython/Jupyter Notebooks it is very simple. Make sure the cell is indeed in markup and to display a image use:

![alt text](imagename.png "Title")

Further advantage compared to the other methods proposed is that you can display all common file formats including jpg, png, and gif (animations).

Files inside the notebook dir are available under a “files/” url. So if it’s in the base path, it would be <img src="https://stackoverflow.com/questions/10628262/files/image.png">, and subdirs etc. are also available: <img src="https://stackoverflow.com/questions/10628262/files/subdir/image.png">, etc.

Update: starting with IPython 2.0, the files/ prefix is no longer needed (cf. release notes). So now the solution <img src="https://stackoverflow.com/questions/10628262/image.png"> simply works as expected.

I am using ipython 2.0, so just two line.

from IPython.display import Image

Getting an image into Jupyter NB is a much simpler operation than most people have alluded to here.

  1. Simply create an empty Markdown cell.
  2. Then drag-and-drop the image file into the empty Markdown cell.

The Markdown code that will insert the image then appears.

For example, a string shown highlighted in gray below will appear in the Jupyter cell:


  1. Then execute the Markdown cell by hitting Shift-Enter. The Jupyter server will then insert the image, and the image will then appear.

I am running Jupyter notebook server is: 5.7.4 with Python 3.7.0 on Windows 7.

This is so simple !!

UPDATE AS OF March 18, 2021:
This simple “Drag-and-Drop-from-Windows-File-System” method still works fine in JupyterLab. JupyterLab inserts the proper HTML code to embed the image directly and permanently into the notebook so the image is stored in the .ipynb file. I am running Jupyter Lab v2.2.7 on Windows 10 Python 3.7.9 still works in JupyterLab. I am running Jupyter Lab v2.2.7 using Python 3.7.9 on Windows 10.

This stopped working in Jupyter Classic Notebook v6.1.5 sometime last year. I reported an bug notice to the Jupyter Classic Notebook developers.

It works again in the latest version of Jupyter Classic Notebook. I just tried it in v6.4 on 7/15/2021. Thank you Jupyter NB Classic Developers !!

If you want to display the image in a Markdown cell then use:

<img src="files/image.png" width="800" height="400">

If you want to display the image in a Code cell then use:

from IPython.display import Image
Image(filename="output1.png",width=800, height=400)


IPython/Jupyter now has support for an extension modules that can insert images via copy and paste or drag & drop.


The drag & drop extension seems to work in most browsers


But copy and paste only works in Chrome.

First make sure you are in markdown edit model in the ipython notebook cell

This is an alternative way to the method proposed by others <img src="https://stackoverflow.com/questions/10628262/myimage.png">:

!Inserting image into IPython notebook markdown(img/picture.png)

It also seems to work if the title is missing:


Note no quotations should be in the path. Not sure if this works for paths with white spaces though!

I put the IPython notebook in the same folder with the image. I use Windows. The image name is “https://stackoverflow.com/questions/10628262/phuong huong xac dinh.PNG”.

In Markdown:

<img src="https://stackoverflow.com/questions/10628262/phuong huong xac dinh.PNG">


from IPython.display import Image
Image(filename="https://stackoverflow.com/questions/10628262/phuong huong xac dinh.PNG")

Change the default block from “Code” to “Markdown” before running this code:


If image file is in another folder, you can do the following:


Last version of jupyter notebook accepts copy/paste of image natively

For those looking where to place the image file on the Jupyter machine so that it could be shown from the local file system.

I put my mypic.png into


(that is the Images folder that shows up in the Jupyter online file browser)

In that case I need to put the following line into the Markdown cell to make my pic showing in the notepad:

![My Title](Images/mypic.png)

minrk’s answer is right.

However, I found that the images appeared broken in Print View (on my Windows machine running the Anaconda distribution of IPython version 0.13.2 in a Chrome browser)

The workaround for this was to use <img src="https://stackoverflow.com/questions/10628262/files/image.png"> instead.

This made the image appear correctly in both Print View and the normal iPython editing view.

UPDATE: as of my upgrade to iPython v1.1.0 there is no more need for this workaround since the print view no longer exists. In fact, you must avoid this workaround since it prevents the nbconvert tool from finding the files.

I never could get “insert image” into a markdown cell to work. However, the drag and drop entered the png file saved in the same directory as my notebook. It brought this text into the cell


The shift + enter > image is now displayed in notebook.


You can find your current working directory by ‘pwd’ command in jupyter notebook without quotes.