Hacker News Board Hacker News, browsed like a classic message board
Live data from Hacker News

Myst Markdown – Markdown for technical/scientific document

mystmd.org

Post reply on HN
Print view View original

31–40 of 47 posts

Re: Myst Markdown – Markdown for technical/scientific document

#32

Post by boxfire »

I've really had a pet peeve about footnotes on mobile and this does the crime. If you click a footnote and it jumps very far away and doesn't have a return navigation, I have left your page usually after the second time I see a footnote and didn't note my exact scroll. A small thing but pretty please don't make me have to hunt for where I was...

Re: Myst Markdown – Markdown for technical/scientific document

#33

Post by keybored »

This is such a complicated domain that you have to have some kind of function-call looking syntax for extensibility (compared to basic lightweight markup which doesn’t). So that’s fine.

    {rolename}`and here is my role's content!`
I would personally prefer something like Tex here. You just need backslashes, square brackets and braces.

I guess this is inspired by Restructured Text. Not a fan of that—it looks like the most punctuation-heavy lightweight markup language.

Re: Myst Markdown – Markdown for technical/scientific document

#34

Post by keybored »

exceptione wrote: post #13

I note that it provides a different dialect of md compared to Obsidian, especially the syntax for admonitions. If one would stray that far, why not AsciiDoc? Myst provides an AST-spec, but I doubt it would be easy to integrate that into Obsidian. Maybe other can shed light on it?

> If one would stray that far, why not AsciiDoc?

And why AsciiDoc in particular? It lists the inspirations for the beyond-Markdown features.

Re: Myst Markdown – Markdown for technical/scientific document

#35

Post by jcranmer »

mnky9800n wrote: post #29
kalleboo wrote: post #19

Earlier quoted context omitted.

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

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

Yes, you can play the rerelease of Riven without VR. I did that a few months ago.

Re: Myst Markdown – Markdown for technical/scientific document

#36

Post by zelphirkalt »

everybodyknows wrote: post #24
zelphirkalt wrote: post #20

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/

Yeah, I have seen the talk! He already reviewed some change I once sent and some bug report. Was very responsive and also gave me hints for what part I would need to change to make a specific thing happen. Very helpful.

Re: Myst Markdown – Markdown for technical/scientific document

#37

Post by rkp8000 »

This reminds me of a project I worked on during my PhD, where you create a network of scientific documents and notes/threads via Markdown, with a similarly structured "rabbit-hole" linking system: https://github.com/rkp8000/hypothesize . I'm not really a software engineer so never made it ready for general use, but I'm very happy to see a similar idea turned into something real! Kudos to the authors.

Re: Myst Markdown – Markdown for technical/scientific document

#38

Post by lima »

zelphirkalt wrote: post #20

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…

> What I haven't seen at a quick glance is the ability to link to any place in the document (sink) from withing the document itself (source).

You can create an anchor:

    (my-anchor)=
...and then link to it:

    [see here](#my-anchor)
(https://mystmd.org/guide/cross-references)

Re: Myst Markdown – Markdown for technical/scientific document

#39

Post by agoose77 »

boxfire wrote: post #32

I've really had a pet peeve about footnotes on mobile and this does the crime. If you click a footnote and it jumps very far away and doesn't have a return navigation, I have left your page usually after the second time I see a footnote and didn't note my exact scroll. A small thing but pretty please don't make me have to hunt for where I was...

Not me mining HN for feature requests... ;)

Re: Myst Markdown – Markdown for technical/scientific document

#40

Post by agoose77 »

irskep wrote: post #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 TypeScr…

MyST-MD is intended to be

> a Sphinx alternative in TypeScript.

We have some unfortunate naming that follows from history. The Python tools you're referring to are a distinct project. The Jupyter Book project saw the development of many of those tools, and is now pivotting to a new engine MyST-MD that this article links to!

Why do you say that these tools aren't complete? Whilst we are certainly not "done", these tools are being used in many places, such as https://proceedings.scipy.org/2024

Looking forward to hearing from you!

Post reply on HN