Guide for Creating Links in FAQ Articles and Tips to Make Sure They Open in Teams Correctly

Creating Links

To create a link in an FAQ article, you can get started in one of two ways:

1. Use the Create Link button to have a link created for you.

2. Type out the Link format inline.

[Link Text](URL) — Used if you want the user to navigate to the link in the same page.

[Link Text](URL){target="_blank"} — Used if you want the user to navigate to the link in a new tab.

Replace Link Text with the text you want to display for the link, and replace URL with the actual URL you want to link to.

The target="_blank" attribute tells the browser to open the linked document in a new tab or window. So, for example, if you want to create a link to Google that opens in a new tab with the text "Google", you would write:

[Google](https://www.google.com){target="_blank"}

Formatting Notes for Links Displayed in Teams

If you want links within FAQs to work well in Teams, there are a few formatting properties to consider:

• If you are linking to page hosted in Chime (FAQ article, page, chat history, etc…) you just need to use [Link Text](URL) format

• If you are linking to a page outside of Chime (SharePoint page, Knowledgebase article, video, etc…) you will need to use the specific [Link Text](URL){target="_blank"} format as they will either not be whitelisted to display, or the content provider will not allow the page to be displayed in Iframes which is what Teams uses to show links.

• Here is some additional documentation on markdown syntax to help if you have any additional questions: Markdown Guide: Links Syntax

Example

This is what it will look like in the Teams client if you have a link to an outside source:

To fix this issue, we will want to update the links to all include the {target="_blank"} attribute to them. This is how it will look for users once that is updated: