pandoc VS mdx

I use Obsidian (https://obsidian.md) for a lot of things, including my RPG stuff, and there are options for exporting things as PDFs. It’s great for getting organized and doing research, but I would use other tools for long-form writing and layout. What I like about Obsidian though is that everything is done in Markdown (https://commonmark.org) and I can use Pandoc (https://pandoc.org) to transform the source to whatever I need. The caveat is that Obsidian uses a flavor of Markdown with some non-standard extensions, so a pure Markdown editor like Typora (https://typora.io) might be a better choice depending on your needs.

My second question is just checking my solution is at all sane. I'm using markdown to make my own character sheets for each playbook, including all the information I think prudent (happy to share if it'd help and not be sharing anything proprietary), and then using pandoc to convert these into word documents. I'm then just sharing these with my players and they can then edit them for their characters and update them as needs be. Is this a reasonable approach? Or is there a better approach?

Especially Haskell tools often live in proximity to nix as well, e.g., pandoc or xmonad.

Tried mkdocs and it is great; beautiful styling and both Markdown and reStructuredText can be used. It would be perfect if I could figure out a way to replace the Markdown -> HTML converter (probably python-Markdown?) with pandoc

You could use pandoc to convert it to a PDF, from which the first page could be extracted (e.g. via pdfseparate(1)) and then converted to an image (e.g. via convert(1)). But perhaps someone else has a more elegant suggestion.

How about https://pandoc.org/

I'm freelancing as a pandoc consultant, and I regularly get to fix bugs and to extend pandoc with additional functionality. My proudest work is the Lua subsystem, which is now used heavily, e.g. in Quarto.

Pandoc automatically converts many (many) formats into beautiful typeset PDF pages. It uses TeX internally, which is strongly-opinionated typesetting software that will largely ignore whatever spacing is in the input document & replace it with what a detail-oriented, perfectionist, founder of Computer Science thought math textbooks should look like in 1978, & it is beautiful.

https://pandoc.org/ can export csv to markdown/orgmode tables

MDX

Last, but certainly not least, among my favorite frameworks is the family of frameworks based on MDX. Before that, let’s understand what is MDX and how does it vary from MD.

Are you a developer looking to create a blog or personal website that is both easy to maintain and visually appealing? Look no further than using Next.js and MDX!

My first reaction was to use MDX and use next/image just as in the example. But that means that we can't use normal markdown images and it turns out that this won't work with contentlayer. This wont work, because Next.js does some magic on the import of the static image. The object which gets returned by the import, contains not only a path to the image, it contains also the width and height, plus a very small version of the image for the blurred placeholder. This magic does not work if the MDX file is loaded with contentlayer, because contentlayer uses its own bundler, which does not know about the import magic for images.

And that's it, we can now hover over our MDX headings and should see a hash to the left. If we click a heading, we should see the id appended to the url in the browser address bar.

I'm using MDX, with Contentlayer and for the code listing I'm using the wonderful Code Hike library.

There is a rise in markdown-based formats to bring capacity for integrating interactive content into documents, namely using web components in markdown. MDX enables using JSX with markdown, the chief aim to bring React components to markdown. Mdsvex brings svelte components to markdown.

Since I was going to write blog posts using MDX, needed good SEO, along with PWA (why not) and with the above mentioned stack, I needed a lot of plugins and by lot I mean A LOT.

MDX

If you opt for Markdown files as your data source for your Gatsby site, you’ll have the option of embedding JSX reusable components into the text using gatsby-plugin-mdx, a Gatsby plugin that adds MDX support to your site. Here are the benefits: