FR: markmap integration

[blaggacao]

https://markmap.js.org/ handily transforms any markdown outline into an interactive mindmap visualization.

For quarto users, this might represent a valuable tool to showcase and transmit their research, for example to provide an intuitive overview over a field of interest.

The unique fit for quarto consists in that the markdown format converts any document in a "double use document" which can produce a mindmap of its outline.

If you're convinced this is useful, integration could have two modes:

• format mode, in which a mindmap derivative of the html format renders the mindmap of a particular document

• inline mode, in which a filter renders the entire outline or parts of it (via ::: blocks) into a placeholder anchor (<div class="markmap"/>) on the same html page

---

As for the Implementation strategy, there's the possibility to do it in-tree with a tight and feature rich integration (similar to reveal.js), or alternatively an extension could provide these features, maybe that would entail somtimes a slightly hacky or unpolished approach.

Overall, ... I think this is really nice and I haven't seen any other issue raising the idea.

[mcanouil]

Why not use the VSCode extension?
If the extension does not allow to set different language ID, ask the maintainers to add a setting for this.
I don't that worth adding complexity and maintenance burden to the quarto extension while the tool is already available as an extension.

https://marketplace.visualstudio.com/items?itemName=gera2ld.markmap-vscode

You could ask support for any user provided language ID or ask to hardcoded quarto alongside markdown.

https://github.com/markmap/markmap-vscode/issues

[blaggacao]

Hm, how did I suppose Quarto as a substitute to an IDE in my Feature Request? — The intentioned use of such an integration is of course the publishing pipeline, and the html target specifically.

[mcanouil]

This repository is about the VSCode/Positron extension and the visual editor, not about Quarto CLI as stated in the README of this repository and in the issue template selector.

https://github.com/quarto-dev/quarto/issues/new/choose

Note that Quarto CLI extensions are there for users to extend Quarto CLI abilities, so you can make one to integrate this tool in Quarto CLI.

[blaggacao]

Ah thanks! Didn't realize that, at all.

Is there a preference to translate this FR accordingly? Or preferably close + create a new one in the right repo?

[mcanouil]

There is a feature request category in Quarto CLI repository in the discussion board.
But, to be frank, it's very unlikely to be something that will be integrated in Quarto CLI, so if you want that, you really should consider making an extension following the documentation.

[blaggacao]

But, to be frank, it's very unlikely to be something that will be integrated in Quarto CLI, so if you want that, you really should consider making an extension following the documentation.

I actually did try that via lua-scripts, but was not able to pull it over some finish line. It seems more complicated than what my current understanding was able to produce. That places things in a bit of a dilemma, as it seems only quarto experts have the capability to implement this.

Anyways, closing here, then.

→ quarto-dev/quarto-cli#12601