Jupyter Notebook to Markdown

Convert a Jupyter notebook into readable Markdown

A notebook file mixes code, notes and results in one document, great for working interactively but awkward to share outside a notebook environment. If you want to post an analysis in a wiki or read it without a notebook program, the raw ipynb file will not cooperate on its own. This tool turns that notebook into a plain Markdown file.

Upload your ipynb file and the tool walks through it cell by cell, turning text cells into ordinary Markdown and wrapping code cells in code blocks so formatting and indentation stay intact. You choose whether to include cell outputs, such as printed text, result values or errors, switched on by default; turning it off gives a cleaner document with just notes and code, useful when outputs were large tables or long logs you do not want in the write-up.

This works well for documentation, sharing a walkthrough with someone who skips notebooks, or pasting an analysis into a report.

Things worth knowing

• Chart or plot images a cell produced are embedded directly in the Markdown file, so it can grow large with many of them.
• Only one notebook converts per run through this tool.
• If you need the other direction, look for Markdown to Jupyter Notebook instead.
• Processing happens on our servers over an encrypted connection, and the file is deleted within 60 minutes.