A way to quickly add a jupytext header to a text file?

[choldgraf]

I was wondering if there's a quick way to add the jupytext header to a file without needing to round-trip it to ipynb first. I find myself writing jupytext-ready markdown files, and then I need to go find another file and copy/paste its jupytext header so that readers will know what kind of jupytext format it is in.

Is there a way to quickly add a header with the default Jupyter kernels available? Something like jupytext init myfild.md <formatname>

[mwouts]

Hello @choldgraf , you can do one of the below:

jupytext --set-formats md:pandoc notebook.md      # set jupytext format to md:pandoc
jupytext --set-kernel - notebook.md               # current python executable
jupytext --set-kernel <kernelname> notebook.md    # explicit kernel name

You may want to use these as well:

jupytext --set-formats md:myst notebook.md
jupytext --set-formats md:pandoc --set-kernel - notebook.md

but unfortunately they don't seem to work at the moment... I will have a look!

[choldgraf]

ah great - OK cool I think we might build in a short-hand for this into jupyter-book, something like jupyter-book init-myst myfile.md. Let me know if the kernel name issue gets fixed

[mwouts]

Apparently all the commands above seem to work fine... I have tested them on a broad range of configurations thanks to #488 .