NOTE: Im not an expert
But It works with jupyter in general, among other stuff, It allows you to have a textual working representation of a notebook, I have use it for julia and python to produce .py
and .jl
runnable scripts. It just add a bunch of comments lines to store important info such that where a cell starts and ends or whether it is a markdown/code cell. After that you can use the .jl/.py/etc file alone to start a new session or in synchronization with a .pynb
file. You can even drop the .pynb
completely and work just using the common text files, but you lose the cell output of previous sessions.
Here and example
# -*- coding: utf-8 -*-
# ---
# jupyter:
# jupytext:
# cell_metadata_filter: -all
# formats: jl,ipynb
# text_representation:
# extension: .jl
# format_name: light
# format_version: '1.5'
# jupytext_version: 1.3.2
# kernelspec:
# display_name: Julia 1.1.0
# language: julia
# name: julia-1.1
# ---
# +
println("How you doooing?")
# -
This is a .jl file equivalent to a .pynb
with a single cell with the print statement.
I primarily use it because the .pynb
is too noise for version control.