When creating links, you can use standard HTML or Markdown formatting. However, you can also implement an automated approach to linking that makes linking much less error-prone (meaning less chances of broken links in your output) and requiring less effort.
Create an external link
When linking to an external site, use Markdown formatting because it’s simplest:
[Google](http://google.com)
Linking to internal pages
When linking to internal pages, you can manually link to the pages like this:
[Icons](mydoc_icons.html)
If you change the file name, you’ll have to update all of your links.