Customer StoriesReadMe Blog

## Internal Links

To create a link between pages, start by typing **\[** and a scrollable menu of available pages to link to will appear. As you start typing more characters, only relevant internal page link options will appear.



The resulting Markdown will look like this:



And end up looking like the link above to users!

Internal links only work within one project.

If you link across multiple projects, you must use standard Markdown hyperlinks.

## Anchor Links

All section headers include an anchor link. The format is #header-name. So for example this [link](🔗) will bring you back to this section:



## External Links

**Inline Linking** To link inline, type the text you want to link within brackets, "[x]", followed directly by the link URL parentheses, "(y)".

Links look like this in the Markdown editor:

188


And result in a link that looks like this: [ReadMe](🔗)

**Reference-Style Linking** Reference-style linking allows you to give a link a number or "name" and refer to it multiple times.

For example, if you type the below in your dash:

528


It looks like this in your hub:

When I first search something I look at [Google][1] then at [Yahoo][2] then [MSN][3].

[1]\: <http://google.com/> "Google"[2]\: <http://search.yahoo.com/> "Yahoo Search"[3]\: <http://search.msn.com/> "MSN Search"

\*If this isn't working you might want to check out [Changing Page URL](🔗)

## Open Links in New Tab

To open an internal link in a new tab


To open an external link in a new tab

## Validating Links
You can use several third-party tools to automatically find broken links you intend to fix, since ReadMe doesn't currently provide a tool for doing so. One simple option:
<https://validator.w3.org/checklink>. No login required. For the **URL** field, enter your doc's custom domain. Select **Hide redirects** and select **Check linked documents recursively**. Leave recursion depth blank.  
Since the results show you only links that are broken, not on **which** pages those links occur or how many times the broken links occur, you may want to export your project to a folder on your local computer. Then you can use a text editor such as Notepad++ to search the exported folder to find out which Markdown pages contain the broken links. You can then fix the broken links in your project's dash.
## What's Next
You can use the **What's Next** section at the bottom of the page to link to relevant pages within your project and/or relevant external links. You can also add a description to provide more context.