Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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

Open
like101101 opened this issue Mar 9, 2023 · 0 comments
Open

Comments

@like101101
Copy link
Collaborator

like101101 commented Mar 9, 2023

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).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant