mdx VS pandoc

Official MDX site

For anyone wondering, MDX is a mix of Markdown and JSX: https://mdxjs.com/.

Storybook simplifies working on those hard-to-reach spots in your codebase by providing an isolated workspace. It is a separate framework-agnostic app within your repository. You can do everything from developing components to documenting all different component states and showcasing them nicely using MDX with clickable demos and interactively changeable component arguments. You can also test your components within Storybook. Storybook's add-on API allows you to tailor it to your needs.

You might want to reconsider the name. MDX is already a well-known technology that combines markdown with JSX https://github.com/mdx-js/mdx/

MDX - write JSX in markdown documents!

I think this would be great as an evolution of MDX (https://mdxjs.com/). MDX is already pretty popular for documentation and it plays well with React but unfortunately there is no framework that adds interactivity to MDX which will enable use cases like data applications.

This is where MDX comes into play. It's essentially a hybrid of JSX / React and a well-specified dialect of Markdown. Essentially, this allows writing texts that are as simple as plain Markdown, as well as creating complex components as you might have done in full JSX.

MDX is great for this, you can intermix JS/TS, JSX, and Markdown

https://mdxjs.com/

You can write your components normally and pass them in to be available in MDX

MDX — Write React code within Markdown.

Semantify was made for content creators, marketers, and anyone looking to enhance their long-form written content. Currently only supporting MDX-based content, It automates the enrichment of MDX blog posts by adding AI-generated Q&A sections that summarize the content, and recommendations for semantically similar posts. This not only makes the content more accessible and engaging but also helps in establishing deeper connections between different posts, ultimately keeping the reader engaged for longer periods.

pandoc: Convert tool, we can use it to covert HTML content to markdown

I get that people don't like the braces in TeX but ... :-)

I'm only half sarcastic here, I don't like them either. I have recently been using pandoc[1] to do the things they are talking about, I had added some stuff in perl using the Template Toolkit[2] to make HTML pages. My issue is that I have very different fugue states for writing vs. coding. Switching states breaks my flow so I've been trying to make the two modes as orthogonal as possible.

I'm curious if anyone has used something like this to go straight to PNG. My use case is that I have a surplus epaper display that can display pngs it fetches from the network and I've been forwarding it my todo list. Have been doing this with a LuaTeX flow but would like something a bit more seamless.

[1] Pandoc -- https://pandoc.org/

[2] Template Toolkit -- https://template-toolkit.org/

wkhtmltopdf is not chromium though? "Wk" literally stands for WebKit.

There's also https://weasyprint.org/ which doesn't use any browser engine, but rather a custom renderer.

And both of those (and Prince) can be used as a backend by Pandoc (https://pandoc.org/)

Pandoc Documentation - Universal

I think TFA is unfair wrt pandoc's dependencies. I'm not sure if the listed "ecosystem" is what you need to build pandoc from source, or just the result of shitty packaging of pandoc from the OS package maintainers.

For the record, the .deb download from [1] gives you a 146MB statically linked pandoc executable that depends only on libc6 (>= 2.13), libgmp10, zlib1g (>= 1:1.1.4).

[1] https://github.com/jgm/pandoc/releases

Another option is Quarto [1]. It's basically a friendly wrapper around Pandoc [2], letting you write in Markdown (+ lots of Quarto-specific extensions) and render to LaTeX, Typst, multi-page HTML, EPUB, docx, and more.

[1] https://quarto.org/

[2] https://pandoc.org/

The resulting Markdown is passed to pandoc to convert it to HTML

To be fair, one there's a good one there's much less incentive to write something new. In this case the good converter is Pandoc: https://pandoc.org/

There are a handful of excellent command-line tools, and Pandoc comes to mind. It is not just a one-trick pony, too. With Pandoc you can convert between many different formats.