mirror of
https://github.com/foambubble/foam-template.git
synced 2025-07-24 02:48:59 +00:00
31 lines
1.3 KiB
Markdown
31 lines
1.3 KiB
Markdown
# 链接参考定义
|
||
|
||
当你使用`[[维基链接]]`时，[foam-vscode](https://github.com/foambubble/foam/tree/master/packages/foam-vscode)插件在文件底部可以生成[Markdown Link Reference Definitions](https://spec.commonmark.org/0.29/#link-reference-definitions)。
|
||
|
||
这样做是为了使文件的内容与不直接支持`[[维基链接]]`的各种 Markdown 工具（例如解析器、静态站点生成器、VS 代码插件等）兼容。
|
||
|
||
默认情况下可以禁用此功能（就像在foam模板中所做的那样），因为你不需要它来导航你的工作区，它对于发版和兼容笔记非常有用。
|
||
|
||
## 示例
|
||
|
||
下面的例子 :
|
||
|
||
```md
|
||
- [[Graph目录可视化]]
|
||
```
|
||
|
||
...在文件底部生成以下链接引用定义:
|
||
|
||
```md
|
||
[Graph目录可视化]: Graph目录可视化"Graph目录可视化"
|
||
```
|
||
|
||
## 配置
|
||
|
||
你可以使用 `foam.edit.linkReferenceDefinitions` 来配置定义（参见 [[VS-Code-入门指南]）：
|
||
|
||
- `withoutExtensions`（默认）：这对某些网络发布工具（例如 GitHub 页面）效果更好
|
||
- `withExtensions`：使用基于 Markdown 的标准工具（例如 GitHub Web UI）效果更好
|
||
- `off`：禁用定义的生成
|
||
|
||
更改工作区中的设置后，你可以运行 `Foam: Run Janitor (Experimental)` 命令来转换所有现有定义。
|