mgnl.createLink() seems to be the proper way to add links to your template. Unfortunately when you need a link with a selector (e.g. /link/to/my/page.with.3.selectors.html), you're out of luck since createLink() always appends ".html" to the link. You would have to remove the extension, add the selectors and append the extension back to the link (= ugly hack). It would be better to have createLink methods where you can also provide the extension, or if set to null or "" no extension is added at all.