two files in the /docs/ directory root:

  • with permalink: /test
  • with permalink: /test/sub

expected result

n ln format rendered ln markdown rendered href note
1 raw permalink ln [ln](/test/sub) "/test/sub" missing baseurl
2 permalink w permalink /test auto-appended? ln [ln](sub) "sub" works but is horrible
3 link tag ln [ln]({% link %}) "/test/sub" missing baseurl
4 relative_url ln [ln]({{ sub | relative_url }}) "" links to current page (/test/)
5 absolute_url ln [ln]({{ sub | absolute_url }}) "" links to current page (/test/)
6 baseurl & link tag ln [ln]({{ site.baseurl }}{% link %}) /oceanobs-rcn/test/sub works!