# Getting Started We are going through the whole workflow of creating and launching an URI to open a note. ## Create URI ### Collect parameters Let's say we want to open the file `Home Index/today.md`. By looking at the [navigation action](Actions/Navigation.md) the only parameter we need is a file [identification](File%20identifiers.md). Since we want to create a new file, we use the `filepath` parameter. As you can see, our file path includes a space and a slash. We have to [encode](Concepts/Encoding.md) special characters. By entering `Home Index/today` (You can omit the file extension) in an [online url encoder](https://www.urlencoder.io/) you get `Home%20Index%2Ftoday` as an output. Now we have the parameter key `filepath` and the parameter value `Home%20Index%2Ftoday`. ### Construct URI As stated in the [Schema](Concepts/Schema.md) every URI has to start with `obsidian://adv-uri`. Please refer to the [Schema](Concepts/Schema.md) for more detailed explanation. Our final URI is the following. ```uri obsidian://adv-uri?filepath=Home%20Index%2Ftoday ``` ## Launch URI There are **many** ways to launch an URI. I'm just listing the most common ### Browser You can simply enter the URI into the search bar. It will ask you to confirm the execution. ### Link in Obsidian You can launch an Obsidian URI from Obsidian itself. Because `obsidian://` is a more custom protocol, it doesn't recognize it as a link directly. To fix this, wrap it in a markdown link. ```md [This here is shown](obsidian://adv-uri?filepath=Home%20Index%2Ftoday) ``` ### Terminal #### Linux ```bash xdg-open "obsidian://adv-uri?filepath=Home%20Index%2Ftoday" ``` #### Mac Use the Mac shell command `open` to launch Obsidian, and with `--background` let Obsidian run in background. ```bash open --background "obsidian://adv-uri?vault=my-vault&filename=my-file&data=my-data" ``` #### Windows PowerShell Use the PowerShell command `Start-Process` to launch an Obsidian URI. ```bash Start-Process "obsidian://adv-uri?filepath=test" ```