Hello! I found the source of your problems with org-tangle.
org-babel-tangle and org-babel-detangle use org-store-link and org-link-search. org-store-link only copies the immediate subtree name and org-link-search can only find immediate subtree names. So if I have a file that looks like #+begin_src org ,* frob ,** bar ,* foo ,** bar #+end_src Then there is no way to link to [[*foo/bar]] The manual mentions that names need to be unique and says that the linter will help you accomplish this. However, from my testing it appears the linter does not warn about duplicated heading names. [[info:org#Internal Links]] Personally, I think adding the ability to link to a heading by a path would be a good feature. However, according to the manual, this particular bug report is user error. It would be nice if a maintainer chimed in here to provide their opinion.
