Render meta.longDescription from markdown

[fricklerhandwerk]

The description of some packages contains markdown, which is currently lost in presentation.

Source: https://github.com/NixOS/nixpkgs/blob/nixos-22.05/pkgs/tools/misc/tmux/default.nix#L69

[ncfavier]

While I think this is reasonable, I can't find any authority on what the format of longDescription is supposed to be (though the convention seems to be markdown). I think this should at least go with a PR in nixpkgs to document in the manual that longDescription should be markdown, to see what people think.

We should also implement markdown rendering for options, following NixOS/nixpkgs#176146. Currently this is not an issue because we delegate the markdown rendering to nixpkgs for nixos options and flake authors have not started using mdDoc/literalMD yet, but it will be at some point.

[deemp]

Hi, @ncfavier . In our flake nix-vscode-extensions, there's packages.x86_64-linux.vscodiumWithExtensions.meta.longDescription. However, this description is not rendered on search.nixos

How can we have the longDescription rendered as Markdown?

[ncfavier]

#607

[deemp]

Okay, thanks!