Supported Markdown syntax

46 views
Skip to first unread message

Bruno

unread,
Nov 9, 2017, 6:11:43 AM11/9/17
to Project Jupyter
Dear all,

What is the exact supported syntax for markdown cells in Jupyter?

I am asking because there are plenty of markdown dialects, such as the ones supported by pandoc (and many more I guess). I'd like to experiment a Jupyter writer in pandoc to be able to convert (as best as possible) documents in Markdown or other formats to Jupyter notebooks, putting code blocks into code cells and the rest in markdown cells.

Thanks!
Bruno

Matthias Bussonnier

unread,
Nov 10, 2017, 1:46:15 PM11/10/17
to jup...@googlegroups.com
Hi Bruno,

There've been am effort to try to document that; see
(https://github.com/jupyter/jupyter_markdown), but we're pretty low
and bandwidth and would need some help.

Cheers,
--
Matthias
> --
> You received this message because you are subscribed to the Google Groups
> "Project Jupyter" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to jupyter+u...@googlegroups.com.
> To post to this group, send email to jup...@googlegroups.com.
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/jupyter/1ddf1a4e-124c-4e92-a8ce-15a7a84eb536%40googlegroups.com.
> For more options, visit https://groups.google.com/d/optout.

Brian Granger

unread,
Nov 12, 2017, 11:19:08 AM11/12/17
to Project Jupyter
Unfortunately, our best answer currently is "whatever our particular
markdown parser supports". We know that is a painful situation to be
in. It is our intention to document the syntax supported in the
classic notebook and then begin to make changes to support commonmark.
The repo that Matthias pointed was a beginning attempt to document how
our markdown compares the commonmark, but the differences were
substantial in the small details.
> To view this discussion on the web visit https://groups.google.com/d/msgid/jupyter/CANJQusWM6x0G2ugUeaVLmKosWjNB9SjdvM9%2Bq6KBNZVBW0anRw%40mail.gmail.com.
> For more options, visit https://groups.google.com/d/optout.



--
Brian E. Granger
Associate Professor of Physics and Data Science
Cal Poly State University, San Luis Obispo
@ellisonbg on Twitter and GitHub
bgra...@calpoly.edu and elli...@gmail.com
Reply all
Reply to author
Forward
0 new messages