# Linking within LivingDoc

## Internal linking between features and scenarios

You can link your features by using their file names in the feature or scenario description. The location of the linked feature file is defined by your folder structure.

### Linking a feature in the root directory

`[Link text](root/Feature.feature)`

### Linking a feature in a sub-directory

`[Link text](root/sub-directory/Feature.feature)`

### Linking a feature without link text

`[](root/Feature.feature)`

If the [Link Text] is not specified, the name of the feature will be displayed by default.

### Linking Example

The following code contains a link to a feature:

```gherkin
Feature: Home Screen

As a potential customer
I want to search for books by a simple phrase
So that I can easily locate books by something I remember from them

The search input is located on the [Home Screen](<BookShop.AcceptanceTests/Features/Book Search.feature>).

Background:
	Given the following books
		| Author        | Title                              |
		| Martin Fowler | Analysis Patterns                  |
		| Eric Evans    | Domain Driven Design               |
		| Ted Pattison  | Inside Windows SharePoint Services |
		| Gojko Adzic   | Bridging the Communication Gap     |

@WI8
Scenario: Title should match
	When I search for books by the phrase 'Domain'
	Then the list of found books should contain only 'Domain Driven Design'
```
**Notes**:

- Markdown is only supported in **Feature and Scenario descriptions**.If you place Markdown elsewhere, you will receive errors when building the documentation

- The markdown syntax supported here is  [**Showdown's Markdown syntax**](https://github.com/showdownjs/showdown/wiki/Showdown%27s-Markdown-syntax). This is why angle brackets <> are used in the link above. Showdown's Markdown syntax requires angle brackets when there is space between characters, notice the blank space between "Book" and "Search" in the link.

- Notice the folder structure in the link example:

    (BookShop.AcceptanceTests/Features/Book Search.feature)

     root: BookShop.AcceptanceTest

     sub-directory: Features

     Feature.feature: Book Search.feature


This is the resulting output in SpecFlow+ LivingDoc:

![Internal link in Gherkin](../_static/images/internal-linkingv2.gif)