Skip to content
The NoteWriter Logo The NoteWriter Logo The NoteWriter Documentation

Gotos

Markdown links can include in their title was is called a Goto. A Goto is a memorable name for a hard-to-remember URL.

The syntax must follow the convention #go/{name}.

## Note: Useful Links


* [Golang](https://go.dev/doc/ "#go/go") was designed by Robert Greisemer, Rob Pike, and Ken Thompson at Google in 2007.
* [Go Playground](https://go.dev/play/ "#go/go/playground") is useful to share snippets.

Gotos can be browsed directly from the terminal:

Terminal window
$ nt go go
# Open a new tab in your browser to https://go.dev/doc/


# Or
$ nt go go/playground

You can also use Gotos (more conveniently) from The NoteWriter Desktop (no need to have a terminal open inside your notes repository).

Placeholders

Goto links support advanced placeholders in their URLs, allowing you to define variables that can be filled in dynamically.

Placeholder Syntax

A placeholder is defined using ${variable} inside the URL. There are several forms:

  • No default value. The value must be entered when expanding the link. Ex: https://github.com/${user}
  • Predefined values. A value must be selected from among options when expanding the link. Ex: https://github.com/${user}/${repo}/${page:[issues,pulls,actions]}
  • Suggestions. A value must be entered but suggestions are offered when expanding the link. Ex: https://github.com/${user}/${repo}/${page:[issues,pulls,...]}
SyntaxDescription
${var}Any value required
${var:[a,b,c]}Must be one of a, b, or c
${var:[a,b,...]}Suggestions: a, b, or any custom value

Example

[Open Issues](https://github.com/${user}/${repo}/${page:[issues,pulls,...]})

When rendered, the CLI (or the desktop application) will prompt for user, repo, and page, offering suggestions for page but allowing any value.