two files in the /docs/ directory root:

  • test.md with permalink: /test
  • test_sub.md with permalink: /test/sub

expected result https://mysite.com/my_baseurl/test/sub

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.md %}) "/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 test_sub.md %}) /oceanobs-rcn/test/sub works!