silverbullet/website/Links.md

You can create three types of links in SilverBullet:

* External links, using the `[title](URL)` syntax, for instance: [SilverBullet community](https://community.silverbullet.md).
* “Naked” URL links, like https://community.silverbullet.md
* Internal links using the `[[page name]]` syntax

# Internal link format
Internal links can have various formats:

* `[[CHANGELOG]]`: a simple link to another page that appears like this: [[CHANGELOG]].
* `[[CHANGELOG|The Change Log]]`: a link with an alias that appears like this: [[CHANGELOG|The Change Log]].
* `[[CHANGELOG$edge]]`: a link referencing a particular [[Markdown/Anchors|anchor]]: [[CHANGELOG$edge]]. When the page name is omitted, the anchor is expected to be local to the current page.
* `[[CHANGELOG#Edge]]`: a link referencing a particular header: [[CHANGELOG#Edge]]. When the page name is omitted, the header is expected to be local to the current page.
* `[[CHANGELOG@...]]`: a link referencing a particular position in a page. This notation is generally automatically generated through templates.
  * `[[CHANGELOG@1234]]`: character in text (starting from 0): [[CHANGELOG@1234]]
  * `[[CHANGELOG@L3]]`: line of text (starting from 1): [[CHANGELOG@L3]]. When column number  is omitted it is assumed to be start of line. This starts from one to match the convention widely used in other text editors.
  * `[[CHANGELOG@L1C3]]`: line and column: [[CHANGELOG@L1C3]]. This also starts from 1 for the start of line. The cursor will be placed at the end of line if the passed number is larger than the line

# Caret page links
[[Meta Pages]] are excluded from link auto complete in many contexts. However, you may still want to reference a meta page outside of a “meta context.” To make it easier to reference, you can use the caret syntax: `[[^SETTINGS]]`. Semantically this has the same meaning as `[[SETTINGS]]`. The only difference is that auto complete will _only_ complete meta pages.
Header docs 2024-01-25 23:05:48 +08:00			`You can create three types of links in SilverBullet:`

			* External links, using the `[title](URL)` syntax, for instance: [SilverBullet community](https://community.silverbullet.md).
			`* “Naked” URL links, like https://community.silverbullet.md`
			* Internal links using the `[[page name]]` syntax

			`# Internal link format`
Meta links (#954) Add carret page link support (for meta pages) 2024-07-17 23:03:25 +08:00			`Internal links can have various formats:`
Header docs 2024-01-25 23:05:48 +08:00
			* `[[CHANGELOG]]`: a simple link to another page that appears like this: [[CHANGELOG]].
			* `[[CHANGELOG\|The Change Log]]`: a link with an alias that appears like this: [[CHANGELOG\|The Change Log]].
Meta links (#954) Add carret page link support (for meta pages) 2024-07-17 23:03:25 +08:00			* `[[CHANGELOG$edge]]`: a link referencing a particular [[Markdown/Anchors\|anchor]]: [[CHANGELOG$edge]]. When the page name is omitted, the anchor is expected to be local to the current page.
			* `[[CHANGELOG#Edge]]`: a link referencing a particular header: [[CHANGELOG#Edge]]. When the page name is omitted, the header is expected to be local to the current page.
Support linking to and moving to line number in pages (#988) Support linking to and moving to line number in pages 2024-07-29 02:31:37 +08:00			* `[[CHANGELOG@...]]`: a link referencing a particular position in a page. This notation is generally automatically generated through templates.
			* `[[CHANGELOG@1234]]`: character in text (starting from 0): [[CHANGELOG@1234]]
			* `[[CHANGELOG@L3]]`: line of text (starting from 1): [[CHANGELOG@L3]]. When column number is omitted it is assumed to be start of line. This starts from one to match the convention widely used in other text editors.
			* `[[CHANGELOG@L1C3]]`: line and column: [[CHANGELOG@L1C3]]. This also starts from 1 for the start of line. The cursor will be placed at the end of line if the passed number is larger than the line
Meta links (#954) Add carret page link support (for meta pages) 2024-07-17 23:03:25 +08:00
			`# Caret page links`
			[[Meta Pages]] are excluded from link auto complete in many contexts. However, you may still want to reference a meta page outside of a “meta context.” To make it easier to reference, you can use the caret syntax: `[[^SETTINGS]]`. Semantically this has the same meaning as `[[SETTINGS]]`. The only difference is that auto complete will _only_ complete meta pages.