Logseq Doctor:在导入 Logseq 之前修复旧的 Markdown 文件

2026-05-26 1 阅读 ankitg12
Logseq Doctor Logseq Doctor:在将旧 Markdown 文件导入 Logseq 之前对其进行修复。 ? 阅读完整文档 注意 该项目仍处于 alpha 阶段,因此它的边缘非常粗糙(文档和功能方面)。目前,它同时具有 Python 和 Go CLI。长期计划是将其转换为 Go,并慢慢删除 Python。新功能将仅添加到 Go CLI。什么是 Logseq Doctor? Logseq Doctor 是一个命令行工具,包含用于操作 Logseq Markdown 文件的命令。它提供的实用程序可以: 将平面 Markdown 转换为 Logseq 的大纲格式 将内容附加到页面和日志 创建可在移动应用程序中轻松查看和优先排序的任务待办事项 在 Logseq 中管理任务 清理和整理 Markdown 文件 防止提交无效内容 还有更多内容... 功能 待办事项管理 ( backlog ):通过智能分类、逾期检测和焦点页面生成将多个页面的任务聚合到统一的待办事项中 内容管理 ( content ):附加原始 Markdown 内容到 Logseq 页面或期刊 Markdown 集成 ( md ):使用 DOM 操作解析和添加 Markdown 内容,支持父块和日志定位 任务管理 ( task add ):通过基于键的搜索添加新任务或更新现有任务,保留子项和属性 整理 ( tidy-up ):清理和标准化您的 Markdown 文件 快速性能:用 Go 编写以提高速度和效率 大纲转换 (outline ):将平面 Markdown 文件转换为 Logseq 的大纲格式 任务列表( 任务 ):列出和管理 Logseq 图中的任务 安装 Go 二进制可执行文件 对于 macOS 和 Linux,推荐的方法是使用 Homebrew 安装:brew install andreoliwa/formulae/logseq-doctor 或者您可以手动安装:go install github.com/andreoliwa/logseq-doctor/cmd/lqd@latest 确认它是否在您的路径中:which lqd # 或 ls -l $(go env GOPATH)/bin/lqd Python 可执行文件 建议的方法是使用 pipx 全局安装 logseq-doctor : pipx install logseq-doctor 您还可以使用以下命令安装开发版本: pipx install git+https://github.com/andreoliwa/logseq-doctor 然后,您将在系统中全局使用 lqdpy 命令。从源代码构建 要从源代码(Python 和 Go 可执行文件)构建和安装,请克隆存储库并运行: make install 快速启动 不带参数键入 lqd(Go 可执行文件)以检查当前命令和选项: Logseq Doctor 修复 Logseq 的 Markdown 文件。将平面 Markdown 转换为 Logseq 大纲、清理 Markdown、防止无效内容以及更多内容。 “lqdpy”是最初用Python编写的CLI工具; “lqd”是 Go 版本。目的是慢慢地将所有内容转换为 Go。用法:lqd [command] 可用命令: backlog 将多个页面的任务聚合为统一的 backlog 完成 为指定的 shell 内容生成自动完成脚本 将原始 Markdown 内容附加到 Logseq help 有关任何命令的帮助 md 使用 DOM 任务将 Markdown 内容添加到 Logseq 管理 Logseq 中的任务(子命令:add) tidy-up 整理 Markdown 文件 标志: -h, --help lqd 的帮助 使用 "lqd [command] --help”以获取有关命令的更多信息。输入不带参数的 lqdpy 以检查当前命令和选项: 用法:lqdpy [选项] 命令 [参数]... Logseq Doctor:在导入旧 Markdown 文件之前修复它们。选项:-g, --graph DIRECTORY Logseq graph [env var: LOGSEQ_GRAPH_PATH; required] --install-completion [bash|zsh|fish|powershell|pwsh] 为指定的 shell 安装完成。 --show-completion [bash|zsh|fish|powershell|pwsh] 显示指定 shell 的完成情况,以复制它或自定义安装。 --help 显示此消息并退出。命令: 轮廓 将平面 Markdown 转换为轮廓。任务 在 Logseq 中列出任务。开发 要设置本地开发: make setup 运行此命令以查看所有可用目标的帮助: make 要运行所有测试,请运行: tox 注意,要合并来自所有 tox 环境的覆盖率数据,请运行: OS Windows set PYTEST_ADDOPTS=--cov-append tox 其他 PYTEST_ADDOPTS=--cov-append tox