Display Jupyter Notebooks with Academic
Learn how to blog in Academic using Jupyter notebooks
from IPython.core.display import Image
Image('https://www.python.org/static/community_logos/python-logo-master-v3-TM-flattened.png')
print("Welcome to Academic!")
Welcome to Academic!
Install Python and JupyterLab
Install Anaconda which includes Python 3 and JupyterLab.
Alternatively, install JupyterLab with pip3 install jupyterlab.
Create or upload a Jupyter notebook
Run the following commands in your Terminal, substituting <MY-WEBSITE-FOLDER> and <SHORT-POST-TITLE> with the file path to your Academic website folder and a short title for your blog post (use hyphens instead of spaces), respectively:
mkdir -p <MY-WEBSITE-FOLDER>/content/post/<SHORT-POST-TITLE>/
cd <MY-WEBSITE-FOLDER>/content/post/<SHORT-POST-TITLE>/
jupyter lab index.ipynb
The jupyter command above will launch the JupyterLab editor, allowing us to add Academic metadata and write the content.
Edit your post metadata
The first cell of your Jupter notebook will contain your post metadata (front matter).
In Jupter, choose Markdown as the type of the first cell and wrap your Academic metadata in three dashes, indicating that it is YAML front matter:
---
title: My post's title
date: 2019-09-01
# Put any other Academic metadata here...
---
Edit the metadata of your post, using the documentation as a guide to the available options.
To set a featured image, place an image named featured into your post’s folder.
For other tips, such as using math, see the guide on writing content with Academic.
Convert notebook to Markdown
jupyter nbconvert index.ipynb --to markdown --NbConvertApp.output_files_dir=.
Example
This post was created with Jupyter. The orginal files can be found at https://github.com/gcushen/hugo-academic/tree/master/exampleSite/content/post/jupyter
Russell W Chan
Engineer, Scientist and Entrepreneur in Biomedical Imaging (HKU, Stanford, NYU)
Dr. Russell Chan is the co-founder and CEO of E-SENSE Innovation & Technology. He obtained his B.Eng. in biomedical engineering and Ph.D. in electrical and electronic engineering from The University of Hong Kong (HKU). He was a post-doc at Stanford University in Neurology and Neurological Sciences, and New York University in Neuroscience, Tech4Health, and Ophthalmology. He was the co-founder and Chief Technology Officer (CTO) of a Forbes Asia 100 to Watch Startup. He received the HKEST award and REVIVE CTO of the Year in 2023. Under his leadership, E-SENSE has received the Tech Impact Company of the Year at the Tech Fest Hong Kong Awards 2025, and Gold Medal with Jury Congratulations at the 50th International Exhibition of Inventions of Geneva in 2025. His focus is the research, development, application, and commercialization of state-of-the-art multi-modal and multi-scale biomedical imaging devices to improve quality of life. Dr. Chan is an elected Junior Fellow of International Society of Magnetic Resonance in Medicine (ISMRM), and an elected Young Fellow of Hong Kong Academy of Engineering (HKAE). He is the ex-co member and the R&D focus group lead of the Hong Kong Institute of Engineers (HKIE) Biomedical Division.