I really like the shape this discussion is taking. Just wanted to chip in and add my two cents:
- There are different use cases and the proposed format would need to take them into consideration
- I believe the goal should not be to replace the
.ipynb
format. This is clear from the above discussion, wanted to reiterate. - I see the text representation as the source code “compiling” to
.ipynb
. This means that the output cells could be ignored for diff purposes. This is the way any other programming language is diffed - My personal preference would be a markdown based format. More specifically the Pandoc’s Markdown format (already supported by jupytext). This is subjective, but I feel that the tooling around MyST is more complex. Besides,
nbconvert
already incorporates pandoc and it could be leveraged in the future.