Link Search Menu Expand Document

Working with Links

Create a new note using lookup called onboarding. Type in the following under the frontmatter.

Read up on `[[`

The [[ tells Dendron that you are about to create a link. Dendron will auto-complete with a matching set of closing brackets ]] as well as give you a list of completions of existing notes.

We are going to create a new note instead of linking to an existing note. So type pro.skynet as your link. pro is short of project in this case.

Read up on [[pro.skynet]]

With your cursor somewhere inside [[pro.skynet]], hit F12. This will create the pro.skynet note. Just like with lookup, Dendron automatically creates notes to links that don't exist when you navigate to them.

You can switch back to the previous note by pressing CTRL-Tab

You can add an alternative title to the link by creating an alias. For example, add the project| to your link to change the name in the preview, (If you've closed your preview, you can open it using CMD+SHIFT+P or WINDOWS+SHIFT+P).

Read up on [[the project|pro.skynet]]

To go back to the previous page, you can either use CTRL-TAB, hit F12 over the link, click the link on the preview, or click the link inside the note while holding down the option or ctrl key (operating system dependent). You have lots of ways to navigate links in Dendron.

When your back on pro.skynet, open the backlinks panel on the bottom left section of your sidebar. The backlinks panel shows you all notes with links that point to the current note. This is useful for helping to establish context.

Note References

Create [[pro.skynet.principals]] inside pro.skynet and navigate to it by using F12. In this new note, write the principles for skynet.

1. Help humans do more
2. Be nice to humans
3. Don't overthrow humanity

While its nice to have principals in its own section, it's something you might want to include in the main project note. To embed a note into another note, Dendron uses note references. You can create a note reference by using CMD|CTRL+SHIFT+R while inside a note. Go ahead and do that now and use CTRL-TAB to switch back to pro.skynet. Now paste the reference. You should have a screen like the one below.

At this point, you can delete your original link ([[pro.skynet.principal]])

Note References (continued)

Note references are extremely powerful and help you re-use your notes in a variety of places. To demonstrate, go back to the pro.skynet.principals and make the following modifications to the text.

## Help humans do more

Skynet should help humans be the best human they can be. Skynet will do this using ultrasophisticated AI to help humans realize their true potential.

## Be nice to humans

Skynet should know that humans are delicate organic lifeforms and treat them as such. Skynet should not hurt their fragile egos or make humans feel bad.

## Don't overthrow humanity

Skynet should not launch nuclear missles or send robots from the future to come back to the past and wipe out humanity. 

Now highlight the first header and use CMD|CTRL+SHIFT+R to create another note reference.

Go back to pro.skynet and add paste your newly created reference. You should end up with the following screen.

A few things to note here

  • notice how the original reference updated with the text of the note.
  • notice that the newly created reference only has the contents from the newly created header
  • notice that the newly created reference doesn't show the actual header itself (you can change this behavior by removing the ,1 inside the reference)

Note references are incredibly powerful. You can do additional things like enter a range of headers to do a reference of, include a reference within a reference, and even reference multiple pages using a wildcard pattern. You can see detailed examples of all these functions in the docs.

Sometimes, you don't want to embed a note but just link to a particular section of a given note. You can do that with Dendron relative links. The syntax to do so is [[{link-name}#{link-header}]]. Dendron will create a relative link automatically if you select the header and use CMD|CTRL+SHIFT+C to create a link (if you don't have a header selected, Dendron will create a regular link to the whole page). When you navigate to a regular link, Dendron will scroll to that specific section of the page.

  • NOTE: relative links are currently not supported in the preview

Something to point out is that you can preview a link by using your mouse to hover over it. This even works for note references.

For links to a file format Dendron does not support, you can use the highlight the link and use > Dendron: Open Link to open the file using your operating system default for that file. This also applies to opening paths to folders.