docs/content/github/managing-files-in-a-repository/working-with-jupyter-notebook-files-on-github.md

title	intro	redirect_from	versions
Working with Jupyter Notebook files on GitHub	When you add Jupyter Notebook or IPython Notebook files with a *.ipynb* extension on {% data variables.product.product_location %}, they will render as static HTML files in your repository.	[/articles/working-with-jupyter-notebook-files-on-github]	[{free-pro-team *} {enterprise-server *} {github-ae *}]

The interactive features of the notebook, such as custom JavaScript plots, will not work in your repository on {% data variables.product.product_location %}. For an example, see Linking and Interactions.ipynb.

To view your Jupyter notebook with JavaScript content rendered or to share your notebook files with others you can use nbviewer. For an example, see Linking and Interactions.ipynb rendered on nbviewer.

To view a fully interactive version of your Jupyter Notebook, you can set up a notebook server locally. For more information, see Jupyter's official documentation.

Troubleshooting

If you're having trouble rendering Jupyter Notebook files in static HTML, you can convert the file locally on the command line by using the nbconvert command:

$ jupyter nbconvert --to html <em>NOTEBOOK-NAME.ipynb</em>

Further reading

• Jupyter Notebook's GitHub repository
• Gallery of Jupyter Notebooks