Skip to content

Jupyterlab MyST extension causing front-end Markdowns failing. #36

@like101101

Description

@like101101

In using Jupyter Book and Jupyter Lab as authoring and developing course-related materials, we highly rely on MyST markdown functionality, especially the code block syntax highlighting with line numbers. Jupyterlab_myst extension allows the book authors/developers to see the MyST markdown in the front end (JupyterLab interface, Markdown Preview, Jupyter Notebook, RISE, etc).

Jupyterlab_myst < 1.0.0 fully supports those front-end interfaces but ignores the MyST directives. Jupyterlab_myst >= 1.0.0 fully supports MyST directives, but only renders the Jupyter Notebook Markdown cell, and does not render other front-end interfaces (they will be displayed as standard Markdown)

As for now, we suggest having the correct MyST syntax and directives in the source code for the books, because this issue will not affect the product of the Jupyter Book (pdf, HTML, etc). JupyterLab Myst developers state that they will provide those support in the future. We can also contribute to this open source project (Note that the node version must be 14 or 16 in order to build the tool from source).

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions