소개
Markdown-Oxide는 Felix Zeller가 개발한 개인 지식 관리(PKM)용 마크다운 언어 서버입니다. Language Server Protocol(LSP)을 통해 사용자가 선호하는 텍스트 편집기와 연동되며, 자체 편집기를 내장하지 않고 지식 관리 기능만 분리해 제공하는 것이 특징입니다. Obsidian의 사용 방식에서 영감을 받아 높은 호환성을 가지며, Rust로 작성되어 있습니다.
상세정보
언어 서버 프로토콜 기반 연동
Markdown-Oxide는 LSP를 구현한 마크다운 언어 서버입니다. 자동 완성, 진단, 참조 검색, 코드 렌즈 등 LSP가 제공하는 다양한 기능을 마크다운 문서 환경에서 활용할 수 있습니다.
언본들드(unbundled) PKM 구조
자체 편집기를 포함하지 않고 지식 관리 기능만 분리해 제공하므로, 사용자가 직접 설정한 텍스트 편집기 환경을 그대로 유지하면서 PKM 기능을 도입할 수 있습니다.
Obsidian과의 높은 호환성
Obsidian의 사용 방식에서 영감을 받아 설계되었으며, 관련 워크플로우와 호환되는 지식 관리 기능을 제공합니다.
다중 편집기 지원
가장 잘 지원되는 편집기는 Neovim이며, 그 외 VSCode, Helix, Zed도 사용자들에게 인기가 있습니다. LSP를 구현한 모든 텍스트 편집기에서 동작하지만, 지원되는 기능의 범위는 편집기의 LSP 구현 정도에 따라 달라질 수 있습니다.
언어 서버 바이너리 설치
먼저 Markdown-Oxide 바이너리를 시스템 경로에 설치해야 합니다. 운영체제별로 다양한 설치 방법이 제공됩니다.
- Arch Linux: pacman -S markdown-oxide
- Nix: pkgs.markdown-oxide
- Alpine Linux: apk add markdown-oxide
- openSUSE: zypper install markdown-oxide
- Conda: conda install conda-forge::markdown-oxide
- Windows(winget): winget install FelixZeller.markdown-oxide
- macOS(Homebrew): brew install markdown-oxide
- 소스에서 직접 빌드: cargo install –locked –git https://github.com/Feel-ix-343/markdown-oxide.git markdown-oxide
- 호스팅 바이너리(cargo binstall): cargo binstall –git ‘https://github.com/feel-ix-343/markdown-oxide’ markdown-oxide
편집기별 설정
Neovim
바이너리를 설치한 뒤 Neovim 0.11 이상에서는 내장된 vim.lsp.config / vim.lsp.enable을 사용해 markdown_oxide 서버를 활성화할 수 있습니다. 기본 lsp/markdown_oxide.lua 설정을 사용하되, dynamicRegistration이 켜진 capabilities를 추가하는 것이 권장됩니다. Neovim 0.11 미만 버전에서는 nvim-lspconfig의 markdown_oxide.setup을 통해 구성합니다. 또한 nvim-cmp 설정에 markdown_oxide의 keyword_pattern을 지정할 수 있습니다.
VSCode
VSCode에서는 FelixZeller.markdown-oxide 확장을 설치합니다. 확장이 서버 바이너리를 자동으로 내려받아 사용하는 방식이 권장되며, 시스템 경로의 markdown-oxide를 사용하도록 설정할 수도 있습니다.
Zed
Zed에서도 Markdown Oxide 확장을 설치해 사용할 수 있습니다. VSCode와 마찬가지로 확장 자체가 바이너리를 내려받는 방식과 시스템 경로의 바이너리를 사용하는 방식 중 선택할 수 있습니다.
Helix
Helix에서는 언어 서버 바이너리를 경로에 설치하는 것만으로 동작합니다.
Kakoune
Kakoune은 kakoune-lsp(v17 이상)를 통해 Markdown-Oxide와 통신합니다. 먼저 kak-lsp를 설치한 뒤, kakrc에 markdown-oxide 서버와 root_globs(.obsidian, .moxide.toml) 설정을 추가합니다.
어떤 텍스트 편집기에서 사용할 수 있나요?
LSP를 구현한 모든 텍스트 편집기에서 사용할 수 있습니다. 가장 잘 지원되는 편집기는 Neovim이며, VSCode, Helix, Zed도 사용자들 사이에서 인기가 있습니다.
VSCode에서 어떻게 설치하나요?
VSCode에서는 FelixZeller.markdown-oxide 확장을 설치합니다. 확장이 서버 바이너리를 내려받아 사용하는 것이 권장되며, 시스템 경로에 설치된 markdown-oxide를 사용하도록 구성할 수도 있습니다.
Kakoune에서 사용하려면 무엇이 필요한가요?
kakoune-lsp를 먼저 설치한 뒤, kakrc에 markdown-oxide 서버와 root_globs(.obsidian, .moxide.toml) 설정을 추가해야 합니다. kakoune-lsp v17 이상이 필요합니다.
Obsidian과 호환되나요?
Obsidian에서 영감을 받아 설계되었으며 높은 호환성을 제공합니다.
시스템 요구사항
Array