makary/foam-template
Template
1
0
Fork 0
mirror of https://github.com/foambubble/foam-template.git synced 2025-06-07 11:58:53 +00:00
Code Issues Projects Releases Packages Wiki Activity
foam-template/docs/features/link-reference-definitions.md
Riccardo d9028e82fb
Added onboarding and major changes to template (#28) 
* removed gitlens

* adjusted various settings

* added foam onboarding to template

* removed prettier extension

* added setting to match OS color scheme

* a couple of minor changes re todos and readme

* added spellright to list of recommended extensions, and added to getting started guide

* added reference to LTeX in spell checking doc

* Added logo to readme

* fixed link to LTeX extension

* styling logo in readme

* more style experiments
2021-01-22 13:17:24 +00:00

1.5 KiB
Raw Blame History

Link Reference Definitions

When you use [[wiki-links]], the foam-vscode extension will automatically generate Markdown Link Reference Definitions at the bottom of the file.

This is done to make the content of the file compatible with various Markdown tools (e.g. parsers, static site generators, VS code plugins etc), which don't support [[wiki-links]] directly.

Example

The following example:

- [[graph-visualization]]

...generates the following link reference definitions to the bottom of the file:

[graph-visualization]: graph-visualization "Graph Visualization"

Configuration

You can use the foam.edit.linkReferenceDefinitions to configure the definitions (see [get-started-with-vscode]):

  • withoutExtensions (default): this works better with certain web publishing tools (e.g. GitHub pages)
  • withExtensions: this works better with standard markdown-based tools (e.g GitHub web UI)
  • off: this disables the generation of definitions

After changing the setting in your workspace, you can run the Foam: Run Janitor (Experimental) command to convert all existing definitions.