Die Wiederentdeckung von MyST Markdown: Mein neues Publikationstool?
Als mir jüngst zwei Videos zu MyST Markdown von unser allwissenden Datenkrake in meinen Feedreader gespült wurden, fiel mir ein, daß mir das Tool vor etwa zwei Jahren schon einmal untergekommen war und ich es so interessant fand, daß ich eigentlich ein paar Tests damit durchführen wollte. Wie aber in vielen solcher Fälle habe ich es aus Zeitmangel aus den Augen verloren und so nehme ich die Wiederentdeckung zum Anlaß, noch einmal über das Thema nachzudenken. Vielleicht wird ja dieses Mal etwas daraus:
MyST Markdown steht für Markedly Structured Text und ist ein Bündel von Werkzeugen zum Verfassen von technischen und wissenschaftlichen Dokumenten. Es ist eine Erweiterung von Sphinx und ein Superset von CommonMark und will die Vorteile von reStructuredText (ReST) mit der Einfachheit von Markdown vermählen.
Das Schwesterprojekt ist Jupyter Book, das (interaktive) wissenschaftliche Publikationen mit Markedly Structured Text aus Jupyter, JuypterLab und JupyterLab Desktop herausschreibt. Die Introduction to MyST Markdown gibt einen Überblick über die Features.
Hier erst einmal die Videos des Users curvenote, die mich zu diesem Beitrag inspirierten:
- Write your next paper in MyST Markdown with data, code & Jupyter notebooks
- Writing a scientific paper faster with MyST Markdown
- Scientific writing in JupyterLab with MyST Markdown
Daneben fand ich auch noch das Video »MyST Markdown: Using notebooks in scientific publishing workflows« von Frank Koch, das dieser auf der JupyterCon 2023 gehalten hat, interessant.
MyST Markdown ist aber nicht nur auf die Nutzung des Jupyter-Ökosystems beschränkt, es kann auch zusammen mit etlichen anderen Tools (zum Beispiel Visual Studio Code oder Quarto (das ja bekanntlich dieses Weblog Kritzelheft antreibt)) genutzt werden und es besitzt auch eine Kommandozeilenschnittstelle. Mehr dazu gibt es in den Tutorials von Dr. Shouke Wei (Medium.com, daher leider hinter einer Bezahlschranke versteckt):
- MyST Markdown Tutorial (I): Preparation to Start.
- MyST Markdown Tutorial (II): A Complete Guide.
- 6 Top Markdown Editors for Writing with MyST: Unlocking the Power of Structured Markdown for Scientific and Technical Content.
- Regularly Used MyST Syntax: Create Beautiful, Interactive, and Executable Technical Books.
- MyST vs Jupyter Book: Choosing the right tool for scientific publishing, technical documentation, and reproducible research.
Was fange ich nun mit all diesen Informationen an? Ich weiß es selber noch nicht, aber es klingt hochinteressant, eventuell mache ich eine Tutorialreihe daraus. Aber ich muß es erst einmal sacken lassen. Daher: Still digging!
Bild: Berlin Beats, erstellt mit OpenArt.ai. Prompt: »Illustration of a badger wearing a red dressing gown and a black beret sits at a table in a street cafe, looking out through a large, sunny window at a bustling Berlin street scene. On the table are a laptop and a large, steaming mug of coffee. Colored DC Comic style. Modell: Seedream 4.0.