[croon]

Yes, but it's easier to fail when the markdown (or NIH markdown in the case of Confluence) is far removed from the code it describes. Which is why you should document closer to the products. Markdown files living by your code and even generated from code is way better than any experience I've had with Confluence (which is closing up on two decades soon enough).

[bartread]

I used Confluence a mere decade ago and, if anything, the 10 years after you used it only magnified its flaws relatively to what else was by then available so you didn’t miss much, and I suspect we haven’t missed much since, except more bloat.