NixOS
Markdown link targets are lost in `:doc`
Describe the bug
nix repl renders markdownlinks as normal text in yellow.
Steps To Reproduce
Load a flake with documented attributes, and use :doc on it.
nix repl nixpkgs
:doc lib
Expected behavior
Render OSC 8 codes to make the link work.
Alternatively, links could be rendered as a list of references at the end.
Metadata
Additional context
Checklist
- [x] checked latest Nix manual (source)
- [x] checked open bug issues and pull requests for possible duplicates
Add :+1: to issues you find important.
Looks like lowdown has added support for LOWDOWN_TERM_NORELLINK in 1.4.0 per @fricklerhandwerk's request originally from https://github.com/NixOS/nix/pull/6968. Could we just use that instead and render URLs as text? Terminal emulators would be able to render those as links.
Discussed in Nix team meeting today:
@xokdvium has suggestions to configure and simplify the markdown rendering.
We don't seem to have strong reasons to stick to the current hacky setup, so we'd love to see this improved.
This issue has been mentioned on NixOS Discourse. There might be relevant details there:
https://discourse.nixos.org/t/2025-06-11-nix-team-meeting-minutes-231/65543/1
