I understand this issue and agree. Maybe it would be helpful to elaborate a bit:
The scenario is that you want to link to a header in Myfile.md
So: [[Myfile#header]] which renders as Myfile>header. OP wants the link to not show the whole path, rendering instead simply as header.
My workaround is exactly as OP described: [[Myfile#header|header]] which has to be done manually, and I agree is friction.
An example of a use case scenario for me is a TOC for a course that I’ve built. It is the difference between the filename being repeated uselessly and adding clutter and having a very clean look with just the headers showing.
No, I’m not rendering math. The “X > Y” rendering format makes the preview less readable by third parties. if [[X#Y]] could be made to render as just Y then I can get the section heading text to flow better when being read.
I’m flexible. Either turn [[X#Y]] into [[X#Y|Y]] automatically, or just change how it previews.
Possibly add a setting to control this so different users can get whatever they need.
Here’s an actual case from my notes.
I have a page “About Richard Feynman” with a section “The Feynman Learning Technique”.
I want the reader to read: The Observe-Reflect-Articulate loop bears some similarity to The Feynman Learning Technique.
The [[X#Y|Y]] workaround looks very clumsy in the editor, but not using the workaround poses a significant challenge for the reader, who may not be accustomed to reading the format produced.