Live data from Hacker News

Myst Markdown – Markdown for technical/scientific document

mystmd.org

21–30 of 47 posts

Re: Myst Markdown – Markdown for technical/scientific document

#24

As a notorious Markdown critic, I have to say, their syntax really looks like a decent attempt of support for technical and scientific documents. Having used reStructuredText for a thesis with a lot of bells and whistles, and having used org-mode mostly ever since, I am not just admitting it willy-nilly. Then of course some of its syntax and syntax concepts are straight out of reStructuredText's book, so it makes sen…

Org-mode has a new maintainer, and he has invited contributions of source code:

https://emacsconf.org/2024/talks/org-update/

Re: Myst Markdown – Markdown for technical/scientific document

#25
This is my favorite syntax for technical writing, but unfortunately the only complete implementation is in Python. There are half-finished JS projects (last I checked) but nothing else. I really wish they were complete so we could use this in more places.

I opted for Djot (https://djot.net) as a second-place alternative with support for many more languages. My use case was attempting a Sphinx alternative in TypeScript. (Link for the curious: https://steveasleep.com/djockey/)

Re: Myst Markdown – Markdown for technical/scientific document

#26
post #2

Looks interesting. The name suggests it uses RestructuredText rather than Markdown. Was that the original plan? Is it appropriate for distill-like articles?

It's Markdown, but you can use it within the same Sphinx ecosystem as reStructuredText.

I use it for a few of my projects and it's fantastic - https://llm.datasette.io for example uses MyST Markdown: https://github.com/simonw/llm/tree/main/docs

Re: Myst Markdown – Markdown for technical/scientific document

#27
post #9

It's in Hugo already.

Do you have a link? I searched and couldn’t find it just two days ago. The only thing I find is that you can achieve similar thing with shortcuts und passthrough. I’m using Sphinx/Myst/pydata theme for my blog which is a very cool combination. But Hugo seems more established.

https://gohugo.io/content-management/mathematics/

For more complex data visuals there's D3: https://observablehq.com/@d3/gallery

Re: Myst Markdown – Markdown for technical/scientific document

#28

As a notorious Markdown critic, I have to say, their syntax really looks like a decent attempt of support for technical and scientific documents. Having used reStructuredText for a thesis with a lot of bells and whistles, and having used org-mode mostly ever since, I am not just admitting it willy-nilly. Then of course some of its syntax and syntax concepts are straight out of reStructuredText's book, so it makes sen…

> there is great potential to have finally good documentation

Yes, true, no good documentation has ever been written in Markdown. Good point.

Re: Myst Markdown – Markdown for technical/scientific document

#29

Earlier quoted context omitted.

I miss playing that game. My father bought the special edition which came with a journal that you could write your notes in it. And we played together taking notes and figuring out the puzzles.

I really enjoyed the recent VR remaster re-release of Riven.

I don’t have a vr device. Is it in normal mode?

Re: Myst Markdown – Markdown for technical/scientific document

#30

As a notorious Markdown critic, I have to say, their syntax really looks like a decent attempt of support for technical and scientific documents. Having used reStructuredText for a thesis with a lot of bells and whistles, and having used org-mode mostly ever since, I am not just admitting it willy-nilly. Then of course some of its syntax and syntax concepts are straight out of reStructuredText's book, so it makes sen…

Most Markdown dialects will support some sort of label or 'span' naming, which provides link targets (if only by dropping down to literal HTML / elements), and it looks like this does too: https://mystmd.org/guide/cross-references#label-anything
Post reply on HN