Principles

Methods

• Vimwiki
  

  Vimwiki提供了类似于org-roam的insert功能，选中文字直接Enter即可在配置的笔记目录下生成笔记。当然也可以 /path/notes 的形式在相对路径的文件夹里生成对应文件。

  VImwiki这个相对路径直接生成文件的实现很重要。在ob里可以直接 [[note1][[note1]] 或 [note1] 引用 note1 ，但这在其他笔记软件里是不支持的。许多md博客生成框架例如hugo，是不支持这种全局通过文件名引用的。Vimwiki支持 [[note1][/pkm/note1]] 这样的格式，保留了相对路径在以后兼容其他框架的时候修改起来就很方便。

  然后就可以开始愉快的写md笔记了。反链暂时我使用正则对当前文件名搜索，得到其他引用文件。Lua还不是很熟，后面写一个脚本来打印出搜索的结果。这个在Emacs里可以通过embark在minibuffer里实现。

  • Lazy安装：

    {'vimwiki/vimwiki'}

    官方文档里，没有直接写明Lazy的安装方式，我还以为不支持，其实是支持的。

  • 配置笔记文件夹

    -- vim
    let g:vimwiki_list = [{'path': '~/vimwiki/',
                          \ 'syntax': 'markdown', 'ext': 'md'}]
    -- lua
    vim.g.vimwiki_list = {
      {
        path = '~/vimwiki/',
        syntax = 'markdown',
        ext = 'md'
      }
    }

• Bash - MD capture
  

  我现在自用的bash脚本包括导航脚本和特定笔记脚本两种，根据这两个模板常用的笔记需求基本可以满足。基本复现org-capture里自定义模板、特定位置写入内容、指定文件生成位置。

  

  • 使用Bash脚本步骤
    
    • 添加脚本文件夹环境全局访问： .bash_profile or .bashrc 文件里写入 export PATH="~/path/my_scripts:$PATH"
    • 添加脚本可执行权限：terminal里 cd ~/path/my_scripts 到脚本文件夹位置， chmod +x script_name.sh
    • 添加别名： alias script_alias='path/my_scripts/script_name.sh' ，然后 source ~/.bash_profile or source ~/.bashrc
    • Nvim里打开terminal或直接打开系统terminal，输入脚本名字或别名。
    • 如果使用的是Homebrew安装的Bash，在脚本里替换 #!/bin/bash 为 #!/opt/homebrew/bin/bash
  • 脚本模板参考
    

    • 导航脚本，选择创建笔记的类型：

      #!/bin/bash
      # 设置退出脚本的陷阱
      trap 'echo "退出脚本。"; exit' SIGINT
      # 定义脚本目录
      script_dir="$HOME/path/"
      # 定义操作和对应的脚本
      declare -A operations=(
        [1]="Journals.sh"
        [2]="NotesMD.sh"
        [3]="AtomicMD.sh"
        [4]="BlogMD.sh"
      )
      # 显示操作选择列表并提示用户输入
      echo "请选择要执行的操作（输入序号）:"
      for i in $(seq 1 ${#operations[@]}); do
        echo "$i. ${operations[$i]}"
      done
      echo "或者输入 'q' 退出脚本"
      # 读取用户输入
      read -p "输入序号: " choice
      # 检查用户是否选择退出脚本
      if [[ "$choice" == "q" ]]; then
        echo "退出脚本。"
        exit
      fi
      # 根据用户输入的序号执行相应的脚本
      if [[ -n "${operations[$choice]}" ]]; then
        script_path="${script_dir}${operations[$choice]}"
        echo "执行 ${operations[$choice]} 脚本..."
        # 执行相应的脚本
        "$script_path"
      else
        echo "无效的序号，请输入1到4之间的数字。"
        exit 1
      fi
      # 提醒用户已执行相应脚本
      echo "已执行选择的脚本。"

    • Journal脚本，生成每天的日志：

      #!/bin/bash
      # 设置系统语言环境为英文
      export LC_ALL=en_US.UTF-8
      export LANG=en_US.UTF-8
      # 设置绝对路径
      base_path="$HOME/path/Journals"
      # 获取当前年份
      current_year=$(date +"%Y")
      # 询问用户输入日期
      read -p "Please enter the date (YYYY-MM-DD or MM-DD) [default: $(date +"%Y-%m-%d")], or 'q' to quit: " input_date
      # 如果用户输入 'q'，则退出脚本
      if [ "$input_date" == "q" ]; then
          echo "Exiting the script."
          exit 0
      fi
      # 如果用户没有输入日期，则使用当天日期
      if [ -z "$input_date" ]; then
          input_date=$(date +"%Y-%m-%d")
      fi
      # 检查输入格式
      if [[ $input_date =~ ^([0-9]{4})-([0-9]{2})-([0-9]{2})$ ]]; then
          # 完整的 YYYY-MM-DD 格式
          input_year=$(echo "$input_date" | cut -d'-' -f1)
          input_month=$(echo "$input_date" | cut -d'-' -f2)
          input_day=$(echo "$input_date" | cut -d'-' -f3)
      elif [[ $input_date =~ ^([0-9]{2})-([0-9]{2})$ ]]; then
          # MM-DD 格式，使用当前年份
          input_year=$current_year
          input_month=$(echo "$input_date" | cut -d'-' -f1)
          input_day=$(echo "$input_date" | cut -d'-' -f2)
      else
          echo "Invalid date format. Please use YYYY-MM-DD or MM-DD."
          exit 1
      fi
      # 生成 Journal 文件路径
      journal_filename="Journal-$input_year.md"
      journal_path="$base_path/$journal_filename"
      # 检查文件是否已存在
      if [ -f "$journal_path" ]; then
          echo "Journal file already exists: $journal_path"
          target_file="$journal_path"
      else
          touch "$journal_path"
          echo "Journal file created: $journal_path"
          target_file="$journal_path"
      fi
      # 获取当前日期信息
      current_date=$(date +"%Y-%m-%d")
      current_month_name=$(date +"%b")
      current_day_name=$(date +"%A")
      # 使用 date 命令获取输入日期的月份和星期几的名称
      input_month_name=$(date -j -f "%Y-%m-%d" "$input_year-$input_month-$input_day" +"%b")
      input_day_name=$(date -j -f "%Y-%m-%d" "$input_year-$input_month-$input_day" +"%A")
      # 检查当前年份头是否存在
      if ! grep -q "# $input_year" "$target_file"; then
          echo "# $input_year" >> "$target_file"
          echo "Current year header inserted in $target_file: # $input_year"
      else
          echo "Current year header already exists, no need to insert it again"
      fi
      # 检查当前月份头是否存在
      if ! grep -q "## $input_year-$input_month $input_month_name" "$target_file"; then
          echo "## $input_year-$input_month $input_month_name" >> "$target_file"
          echo "Current month header inserted in $target_file: ## $input_year-$input_month $input_month_name"
      else
          echo "Current month header already exists, no need to insert it again"
      fi
      # 检查当前日期头是否存在
      if ! grep -q "### $input_year-$input_month-$input_day $input_day_name" "$target_file"; then
          echo "### $input_year-$input_month-$input_day $input_day_name" >> "$target_file"
          echo "Current day of the week header inserted in $target_file: ### $input_year-$input_month-$input_day $input_day_name"
          echo "" >> "$target_file"
          echo "- TODOs" >> "$target_file"
          echo "- Inbox" >> "$target_file"
          # 将光标定位在"- Inbox"这一行
          sed -i '' -e '/- Inbox/G' "$target_file"
      else
          echo "Current day of the week header already exists"
      fi
      # 用Typora打开生成的日记文件
      open -a Typora "$target_file"

    • Notes脚本，生成一般的笔记：

      #!/bin/bash
      # 提示用户输入Markdown文件的名称，并检查是否输入了"q"以退出脚本
      while true; do
        read -p "请输入Markdown文件的名称（不包含.md扩展名）或输入'q'退出: " filename
        if [[ "$filename" == "q" ]]; then
          echo "退出脚本。"
          exit
        fi
        # 如果用户没有输入任何内容，则使用当前日期和时间作为文件名
        filename=${filename:-$(date '+%Y%m%d%H%M%S')}
        # 检查输入是否有效，如果为空则继续询问
        if [ -z "$filename" ]; then
          echo "文件名不能为空，请输入文件名或输入'q'退出。"
          continue
        fi
        # 一旦获得有效输入，跳出循环
        break
      done
      # 检查是否已经存在该目录，如果不存在则创建
      mdNotesDir="$HOME/path/"
      if [ ! -d "$mdNotesDir" ]; then
        mkdir -p "$mdNotesDir"
      fi
      # 构建完整的文件路径
      fullPath="${mdNotesDir}${filename}.md"
      # 获取当前的日期和时间
      current_date=$(date '+%Y-%m-%d')
      current_date_yyyyMMddHHmmss=$(date '+%Y%m%d%H%M%S')
      # 创建并写入 YAML 头信息到 Markdown 文件
      cat > "$fullPath" <
      

• ToggleTerm
  

  

  akinsho/toggleterm.nvim 可以在Nvim里快速创建一个内置终端。结合Bash脚本，体验和Emacs里使用org-capture差不多。当然，org-capture可以结合org-protocol，还是要强大太多。

  • 安装：

      {
        -- amongst your other plugins
        {'akinsho/toggleterm.nvim', version = "*", config = true}
        -- or
        {'akinsho/toggleterm.nvim', version = "*", opts = {--[[ things you want to change go here]]}}
      }

  • 参考配置：

    local toggleterm = require("toggleterm")
      toggleterm.setup({
          size = 15, - 设置窗口大小
          open_mapping = "",
          start_in_insert = true,
          direction = "horizontal", - 设置窗口横向或竖向
          shell = vim.o.shell, - 设置需要使用的shell
      })
      - 在Terminal里使用vim的移动指令
      function _G.set_terminal_keymaps()
        local opts = { noremap = true }
        vim.api.nvim_buf_set_keymap(0, 't', '', [[]], opts)
        vim.api.nvim_buf_set_keymap(0, 't', 'jk', [[]], opts)
        vim.api.nvim_buf_set_keymap(0, 't', '', [[h]], opts)
        vim.api.nvim_buf_set_keymap(0, 't', '', [[j]], opts)
        vim.api.nvim_buf_set_keymap(0, 't', '', [[k]], opts)
        vim.api.nvim_buf_set_keymap(0, 't', '', [[l]], opts)
      end
      vim.cmd('autocmd! TermOpen term://* lua set_terminal_keymaps()')
      local Terminal = require("toggleterm.terminal").Terminal
      local lazygit = Terminal:new({ cmd = "lazygit", hidden = true })
      function _LAZYGIT_TOGGLE()
        lazygit:toggle()
      end
      local node = Terminal:new({ cmd = "node", hidden = true })
      function _NODE_TOGGLE()
        node:toggle()
      end
      local python = Terminal:new({ cmd = "python3", hidden = true })
      function _PYTHON_TOGGLE()
        python:toggle()
      end
      -- 为 Python 终端设置快捷键
      vim.api.nvim_set_keymap('n', 'tp', ':lua _PYTHON_TOGGLE()', { noremap = true, silent = true })
      -- 快速打开Terminal
      vim.keymap.set("n", "tt", function()
        require("toggleterm").toggle()
      end, { desc = "ToggleTerm" })
      -- end

• 中英输入法问题
  
  • im-select-nvim
    

    keaising/im-select.nvim 这个插件可以在Nvim里让nomal模式下自动切换成英文输入，在insert模式下自动切换回中文输入。刚需。

    • 先安装im-select

      Install
      Download URL: https://github.com/daipeihust/im-select
      Check installation in bash/zsh
      # find binary
      $ which im-select
      # Get current im name
      $ im-select
      # Try to switch to English keyboard
      $ im-select com.apple.keylayout.ABC
      Check in NeoVim
      :!which im-select

    • im-select-nvim的安装和配置

      {
          "keaising/im-select.nvim",
          config = function()
              require('im_select').setup({
                  -- IM will be set to `default_im_select` in `normal` mode
                  -- For Windows/WSL, default: "1033", aka: English US Keyboard
                  -- For macOS, default: "com.apple.keylayout.ABC", aka: US
                  -- For Linux, default:
                  --               "keyboard-us" for Fcitx5
                  --               "1" for Fcitx
                  --               "xkb:us::eng" for ibus
                  -- You can use `im-select` or `fcitx5-remote -n` to get the IM's name
                  default_im_select  = "com.apple.keylayout.ABC",
                  -- Can be binary's name, binary's full path, or a table, e.g. 'im-select',
                  -- '/usr/local/bin/im-select' for binary without extra arguments,
                  -- or { "AIMSwitcher.exe", "--imm" } for binary need extra arguments to work.
                  -- For Windows/WSL, default: "im-select.exe"
                  -- For macOS, default: "im-select"
                  -- For Linux, default: "fcitx5-remote" or "fcitx-remote" or "ibus"
                  default_command = "/opt/homebrew/bin/im-select",
                  -- Restore the default input method state when the following events are triggered
                  set_default_events = { "VimEnter", "FocusGained", "InsertLeave", "CmdlineLeave" },
                  -- Restore the previous used input method state when the following events
                  -- are triggered, if you don't want to restore previous used im in Insert mode,
                  -- e.g. deprecated `disable_auto_restore = 1`, just let it empty
                  -- as `set_previous_events = {}`
                  set_previous_events = { "InsertEnter" },
                  -- Show notification about how to install executable binary when binary missed
                  keep_quiet_on_no_binary = false,
                  -- Async run `default_command` to switch IM or not
                  async_switch_im = true
              })
          end,
      },

    Ref:

    • 完善 Rime Vim Mode：支持 Linux & 自动切换回中文模式 · Issue #85 · lei4519/blog
    • Vim 的中文支持及解决思路 - 少数派
    • 如何让 Neovim 中文输入时自动切换输入法 · Blowfish
  • RIME
    

    如果说PKM是纸，那么输入法就是笔。

    再次强烈推荐 RIME | 中州韻輸入法引擎，配合 iDvel/rime-ice: Rime 配置：雾凇拼音 | 长期维护的简体词库，多平台多端同步。已经使用了几年，非常巴适，手机端也可以同步配置。

    以前输入法就各种偷偷记录用户输入习惯，现在各个输入法又还要内置AI再记录一遍。本地配置、不需要联网的输入法是我的刚需，更何况，rime还可以自挂词库。

    一个巨坑，最近的RIME更新在Release 1.0.0 · rime/squirrel版本里改变了候选词横向和竖向的设置：

    style/horizontal 將徹底移除，雖然本版程序仍支持，但會被新控件的默認值覆蓋
    請使用 candidate_list_layout: stacked/linear 和 text_orientation: horizontal/vertical

    而且最好直接在输入法外观的配置文件里，修改输入法外观的配置，而不是通用配置，反正我在通用设置里不起作用。

    下面是简单的安装步骤 ：

    ;; mac:
    ;; mac rime: https://rime.im/download/
    Homebrew: brew install --cask squirrel
    或者直接下载
    ;; mac rime-ice
    使用东风破 plum 安装: https://github.com/rime/plum
    curl -fsSL https://raw.githubusercontent.com/rime/plum/master/rime-install | bash
    安装 rime-ice:
    ℞ 安装或更新全部文件
    bash rime-install iDvel/rime-ice:others/recipes/full
    ℞ 安装或更新所有词库文件（包含下面三个）
    bash rime-install iDvel/rime-ice:others/recipes/all_dicts
    ℞ 安装或更新拼音词库文件（ cn_dicts/ 目录内所有文件）
    bash rime-install iDvel/rime-ice:others/recipes/cn_dicts
    ℞ 安装或更新英文词库文件（ en_dicts/ 目录内所有文件）
    bash rime-install iDvel/rime-ice:others/recipes/en_dicts
    ℞ 安装或更新 opencc （ opencc/ 目录内所有文件）
    bash rime-install iDvel/rime-ice:others/recipes/opencc
    ;;或使用 rime-auto-deploy：https://github.com/Mark24Code/rime-auto-deploy，这个和plum只用选一个。
    =======================================================
    ;;Linux
    ibus:
    https://github.com/rime/home/wiki/RimeWithIBus
    sudo apt-get install ibus-rime                   #ibus
    fcitx5:
    sudo pacman -Sy fcitx5-rime                      # Arch Linux
    sudo apt update && sudo apt install fcitx5-rime  # Ubuntu / Debian / Deepin
    sudo zypper install fcitx5-rime                  # OpenSUSE
    sudo dnf install fcitx5-rime                     # Fedora
    plum and rime-ice：
    git clone --depth 1 https://github.com/rime/plum ~/plum
    ;; 切换到东风破的目录
    cd ~/plum
    ;; 如果你使用Fcitx5，你需要加入参数，让东风破把配置文件写到正确的位置
    rime_frontend=fcitx5-rime bash rime-install iDvel/rime-ice:others/recipes/full
    ;; 如果你是用IBus，则不需加参数，因为东风破默认是为IBus版的RIME打造。
    bash rime-install iDvel/rime-ice:others/recipes/full

    其他可以参考下面的文章:

    • 自由输入法 RIME 简明配置指南 - 少数派
    • RIME + 雾凇拼音，打造绝佳的开源文字输入体验 - 少数派
    • 让 RIME 体验更上一层楼：如何用 MediaWiki 扩展词库 - 少数派 导入wiki
    • gshang2017/rime-dict: RIME输入法(拼音)自用词库(包含英语，基础，维基，搜狗等词库)，词频基于腾讯AI向量词库逆序生成。 自建词库，导入专业领域词汇
• MarkdownPreview
  

  iamcco/markdown-preview.nvim提供实时的markdown预览，对于经常写md的不是那么必须，拿不准的可以预览看看的整体效果。输入 :MarkdownPreview 就会在浏览器里打开预览。

  当然，还有个更简单的办法，在Typora里打开:

  -- 定义一个函数,用于在 Typora 中打开当前缓冲区文件 --
  local function open_with_typora()
      local current_file = vim.api.nvim_buf_get_name(0)
      vim.cmd('!open -a Typora "' .. current_file .. '"')
  end
  -- 将该函数绑定到 t 快捷键
  vim.keymap.set('n', 'fo', open_with_typora, { desc = 'Open current buffer in Typora' })
  -- end

  • 安装

    在Nvim里使用Lazy安装会报错，这个 issue 给出了解决办法：

      {
        -- Install markdown preview, use npx if available.
        "iamcco/markdown-preview.nvim",
        cmd = { "MarkdownPreviewToggle", "MarkdownPreview", "MarkdownPreviewStop" },
        ft = { "markdown" },
        build = function(plugin)
          if vim.fn.executable "npx" then
            vim.cmd("!cd " .. plugin.dir .. " && cd app && npx --yes yarn install")
          else
            vim.cmd [[Lazy load markdown-preview.nvim]]
            vim.fn["mkdp#util#install"]()
          end
        end,
        init = function()
          if vim.fn.executable "npx" then vim.g.mkdp_filetypes = { "markdown" } end
        end,
      },

  • 配置

    其他的基本不用怎么配置，下面是指定浏览器的配置：

    Add the following to your Neovim init script:
    Linux
      function OpenMarkdownPreview (url)
        execute "silent ! firefox --new-window " . a:url
      endfunction
      let g:mkdp_browserfunc = 'OpenMarkdownPreview'
    Replace firefox with chrome if you prefer. Both browsers recognize the --new-window option.
    macOS
      function OpenMarkdownPreview (url)
        execute "silent ! open -a Firefox -n --args --new-window " . a:url
      endfunction
      let g:mkdp_browserfunc = 'OpenMarkdownPreview'
    Replace Firefox with Google\ Chrome or Brave\ Browser if you prefer. They all recognize the --new-window option.

• 网页摘录和after-reading
  

  利用org-capture，做剪藏和摘录很方便。现在保存在~clip.org~文件里，可以在agenda里按时间线回顾，由于agenda里只有标题，也起到了类似Anki卡片回顾的作用：

  有一个JavaScript我一直在用，可以选定一个网页的特定内容，在翻译和剪藏的时候挺有用，同时也微微提升了一点阅读体验。我用 DeepLX 通过沉浸式翻译如果单次翻译内容太多会报错和限制，Deepl的中文翻译还是吊打其他的。

  下面的代码保存到书签，单击书签就可以了：

  javascript:(function(){var e=document.body;const n=document.head.appendChild(document.createElement("style"));n.textContent=".mainonly { outline: 2px solid red; }";const t=CSS.supports("selector(:has(*))");function o(n){n instanceof HTMLElement&&(e.classList.remove("mainonly"),(e=n).classList.add("mainonly"))}function s(e){o(e.target)}function a(o){if(o.preventDefault(),t)n.textContent=":not(:has(.mainonly), .mainonly, .mainonly *) { display: none; }";else{n.textContent=":not(.mainonly *, .mainonly-ancestor) { display: none; }";var s=e;do{s.classList.add("mainonly-ancestor")}while(s=s.parentElement)}l()}function i(n){n.preventDefault(),n.deltaY<0?o(e.parentElement):o(e.firstElementChild)}function l(){document.removeEventListener("mouseover",s),document.removeEventListener("click",a),document.removeEventListener("wheel",i)}document.addEventListener("mouseover",s),document.addEventListener("click",a),document.addEventListener("wheel",i,{passive:!1}),document.addEventListener("keydown",(function o(s){if("Escape"===s.key&&(n.remove(),document.removeEventListener("keydown",o),l(),e?.classList.remove("mainonly"),!t))for(const e of document.getElementsByClassName("mainonly-ancestor"))e.classList.remove("mainonly-ancestor")}))}())

  after-reading我一直用的 Omnivore，开源免费，支持RSS和Newsletter，可以自动同步高亮标注、摘录到Obsidian和Logseq。这部分用来做 流动知识的检索，文档+RAG现在的项目也越来越多了。用AI来过滤、总结这些信息流很巴适。

  简单写了一个python用来直接获取高亮摘录并与本地LLM问答：RSS 订阅和本地 LLM 结合的初步尝试 - 流动知识检索 | Vandee's Blog

  有条件直接上 Readwise，配合Notion、Obsidian、Logseq都挺好用。Pocket、memos 也挺不错，可以把阅读整合到PKM里。

  欢迎来到 n8n 中文教程 | 简单易懂的现代魔法这里给出了一个 omnivore 到 notion 的 workflow。

  最近还是入坑了 Readwise。

  • tools
    

    • 网站：https://jina.ai/reader/

      Github：https://github.com/jina-ai/reader

      它可以提取网页内容并转换为markdown格式，还支持直接搜索，支持API。

      Reader does two things:

      • Read: It converts any URL to an LLM-friendly input with https://r.jina.ai/https://your.url. Get improved output for your agent and RAG systems at no cost.
      • Search: It searches the web for a given query with https://s.jina.ai/your+query. This allows your LLMs to access the latest world knowledge from the web.

      添加下面代码到书签保存，点击书签就可以提取网页内容到markdown格式了。

        javascript: var currentUrl = window.location.href;var newUrl = "https://r.jina.ai/" + currentUrl;window.open(newUrl, '_blank');window.history.pushState({}, '', currentUrl);

    以这个工具为跳板，就可以干许多有意思的事情了。

    • JimmyLv/BibiGPT-v1 这个项目可以自己部署，总结B站、YouTube、抖音等等的视频内容，挺好用。
    • u-Sir/drag-to-preview，最近发现一个Firefox浏览器插件，可以选中网页链接拖拽弹出单独的窗口预览网页，在窗口外区域鼠标点击即可关闭，很符合我的胃口。

Ollama

Open WebUI

Kotaemon