gitee markdown 笔记_Foam-vscode笔记入门/教程

foam是什么？

foam是支持双向链接的vscode笔记插件。类似obsidian或者roam research。官网：foambubble/foam

什么是双向链接？ 简单理解：通过点击 [[文件名]] 可以跳转到相应的文件（相当于智能的超链接），而且还可以查到谁（哪个文件）链接了这个文件，利用这种关系可以做出一个“知识图谱”

• 要了解更多有关使用Foam的信息，请阅读
  • 英文：foam的官方文档
  • 国内无法访问官方文档的话，可以访问gitee迁移页面
  • 英文：使用技巧Recipes
  • 中文：翻译文档
  • Foam-QQ交流群：610013037

安装

下面的内容参考Foam中文文档

安装Vscode

• vscode下载链接：Visual Studio Code
• 设置vscode的显示语言：进入vscode后，输入Crtl+Shift+P(或点击View>Command Palette)进入命令面板，然后输入「configure language」，选择「Configure Display Language」，然后就可以安装中文显示插件啦！

安装Foam（Foam是vscode的插件）

• 1、使用foam-template生成一个新的git存储库
  • 如果您已经登录github，那么你就可以点击这个链接直接创建：Use this template
  • 请注意，如果你想保留你自己的构思，请记住把存储库设置为私有
  • 或者你压根不想在github上托管或者没有github账户，那么请点击此链接下载Foam模板的zip文件：Download foam-template's zip file

• 2、将你的git存储库克隆到本地，然后用vscode打开
  • 在vscode中，选择「File>Open...」来打开你的存储库

• 3、当出现提示安装推荐的插件时，选择[Install All]安装全部，或者点击[Show Recommendations]来选择安装插件

快捷键&命令

创建实用快捷键

我们还可以给vscode添加一些很实用的快捷键，在keybindings.json文件里头添加配置，具体如下

修改、自定义快捷键的方法

常用命令

首先Ctrl + shift + P打开命令窗口，然后输入下面的命令

插件

必须安装的插件

见foam帮助文档

推荐安装的插件

• todo highlight ： 这样就可以做到对某些文本进行高亮啦
• material theme：vscode样式主题，能让你在编辑文件的时候有漂亮的样式，部分解决所见即所得的需求，我用的是这个主题包里的Monokai dimmed
• image preview：鼠标悬停在图片链接上的时候可以看到图片！
• markdown image ：以便支持在markdown中快速插入图片并放到指定的位置
• markdown checkbox： 管理你的todo

常见问题

修改字体为微软雅黑

• ctrl + ,打开设置，进入font设置，改成"editor.fontFamily": "Consolas, 'Courier New', monospace, '微软雅黑'",

大纲/目录在哪?

1. 侧边栏, 直接打开左侧的outline
2. 在文件中插入目录, 打开命令窗口, create toc

http://github.io无法访问,如何查看foam的帮助文档

下载https://foambubble.github.io/foam/这个github仓库,用vscode打开, 进入docs文件夹, 然后就可以用foam/双向链接的方式来浏览了

从obsidian迁移过来的注意点

1. 文件命名问题, 只能接受全小写的, 以-连接的名称, 例如[[file-format-style]]
2. 需要保证每个md文件开头都有一个 ## heading heading的名称可以改

修改默认文件夹

1. dailynote的文件夹
2. 截图的文件夹

Markdown设置tab为4个空格

在vscode设置为tab为4个空格, 为什么对markdown文件还是不生效呢? 解决方法见 https://www.jianshu.com/p/2ab1ffe53b31

新建笔记在一个默认文件夹下?

在setting.json中添加

"vscodeMarkdownNotes.newNoteDirectory": "docs/",

将笔记分享到github/gitee page上

1. 使用mkdocs-material（推荐） 教程：https://github.com/jackiexiao/foam-mkdocs-template
2. 使用官方的模板 https://github.com/foambubble/foam-template

插入图片?

安装插件 markdown image，然后使用快捷键 alt shift v 插入图片