Internal Links
A user may wish to create a link which points to an internal link (a page which exists within the same domain, or on the knarly platform). However the problem with links on the web is that they tend to ermm. disappear. The webmaster might forget to update them when they change. However on knarly changes to the site structure are known and so links can be updated accordingly.
So if a user creates the link on their website
<a href='http://knaly.com/documentation/'>Knarly Documents</a>
... and we at knarly change this too
http://knaly.com/documentation_and_tutorials/
Then all site links will be updated.
Furthermore...
A kind of widget can be introduced for creating links quickly, but relies on the user knowing the ID of the item they are trying to view.
e.g.
[#568]
Would create a link to this page with the title of the page as the text.
<a href='/documentation/advanced/internal_links/'>
Internal Links
</a>
Alternatively the text could be overwritten by a "label:label" i.e.
[#568:label:"Knarly info on Links";]
If you wanted to create a button link we use
[#714:button;label:Add an article;]
For External links see the Widget section