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.
Edit me
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.