
2026/04/17 1:08
「Marky:エージェント型コーディング向け、軽量なマークダウンビューアーを公開しました(Show HN)」
RSS: https://news.ycombinator.com/rss
要約▶
Japanese Translation:
Marky は Tauri v2、React、Rust(Electron を置き換える)を用いて構築された macOS 向け高速で軽量な Markdown ビューアです。サイズは 15 MB 未満という驚くほど小さいフットプリントを持ち、ターミナルから直接ファイルを開く機能(
marky FILENAME)または持続的な Obsidian スタイルのワークスペース(marky FOLDER)を実現します。主な機能には、ライブディスクリロード、Cmd+K を 통한ファジー検索、Shikiによるシンタックスハイライトリング、KaTeXによる数式レンダリング、Mermaid図表、GFMサポートが含まれます。未確認ファイルの表示時の安全性を確保するため、DOMPurify を用いてコンテンツをサンタイズ化し、システム設定に合わせて明るいテーマ/暗いテーマを採用します。現在、Apple Silicon Mac(ARM)向けに署名されていないベータ版として利用可能であり、セキュリティゲートウェイを回避するために xattr -cr /Applications/Marky.app といった一時的なコマンドが必要となる場合があります。このプロジェクトは CLI/I/O/バックエンドに Rust、フロントエンドに React/Tailwind CSS を使用しています。今後の更新では x86 と Linuxへのサポート拡大、Claude Code/Codex との AI チャット統合、Git.diff レビュー機能の追加が計画されています。プルリクエストを通じてコントリビューションを歓迎し、テスト実行後に提出してください。本文
Marky: macOS 向け高速ネイティブ Markdown ヴィューア
Tauri v2、React、および markdown-it を採用して開発されました。表、コードブロック、タスクリスト、数式、図の美しく正確なレンダリングを実現し、ライブリロード機能を備えています。
目次
プロジェクトについて
Marky は、1 つの目的のために設計されたデスクトップ用 Markdown ヴィューアです。それは、ターミナルから
.md ファイルを開き、美しく瞬時のレンダリングを提供することです。marky FILENAME コマンドでファイルを閲覧するか、marky FOLDER コマンドで Obsidian スタイルの持続的なワークスペースとしてフォルダーを開くことができます。ディスク上でファイルが変更されるたびに自動的にリロードされ、Claude が生成した計画書やドキュメント、メモを執筆最中に閲覧するのに最適です。
機能
- CLI フースト (コマンドラインファースト) —
でウィンドウを開き、marky README.md
でフォルダーを開くことができます。marky ./docs/ - ライブリロード — エディタや Claude などからディスク上の編集内容は即座にビューに反映されます。
- フォルダー管理 — Obsidian スタイルの持続的なワークスペースとしてフォルダーを追加できます。サイドバーに表示され、起動時に復元されます。
- Cmd+K コマンドパレット — Nucleo によるファジー検索を活用し、開いているすべてのフォルダー内でファイルを曖昧検索できます。
- シンタックスハイライト — Shiki と VS Code のテーマを組み合わせて、正確で美しいコードブロックを実現します。
- 数式 —
および$inline$
形式の数式のレンダリングには KaTeX を使用しています。$$display$$ - Mermaid 図 — フェンス付き Mermaid ブロックを SVG としてレンダリングします。
- GFM (GitHub Flavored Markdown) — 表、タスクリスト、取り消し線、オートリンク、脚注をサポートします。
- ライトテーマとダークテーマ — システムの好みを追従するか、手動で切り替えることができます。
- 無害化されたレンダリング — すべての HTML は DOMPurify を通して処理され、信頼できない Markdown の閲覧も安全です。
- 軽量かつ高速 — ネイティブな Webviewを採用しており Electron は使用しません。配布用
ファイルのサイズは 15 MB 未満です。.dmg
インストール
Homebrew を使用して
備考: 現在 Apple の審査待ちのため、一時的にアプリは署名されていません。この状況は近日中に解決されます。
brew tap GRVYDEV/tap brew install --cask GRVYDEV/tap/marky # バイナリを署名するまで仮対応として実行します xattr -cr /Applications/Marky.app
ソースコードから
Rust、Node.js、pnpm のインストールが必要です。
git clone https://github.com/GRVYDEV/marky.git cd marky pnpm install pnpm tauri build ./scripts/install-cli.sh
インストールスクリプトは
marky を ~/.local/bin/ にシンリンクリンクします。以下のように PATH に含めることを確認してください:
- bash/zsh:
export PATH="$HOME/.local/bin:$PATH" - fish:
set -Ux fish_user_paths $HOME/.local/bin $fish_user_paths
使用方法
# シングルファイルを開く marky README.md # ワークスペースとしてフォルダーを開く marky ./docs/ # 引数なしで起動 — 直前のセッションを復元します marky
キーボードショートカット
| ショートカット | 動作 |
|---|---|
| Cmd+K | コマンドパレット (ファジーファイル検索) |
| Cmd+O | ファイルを開く |
| Cmd+Shift+O | フォルダーを追加 |
| Cmd+F | ページ内検索 |
開発
pnpm install pnpm tauri dev # HMR付きの開発サーバー
テストの実行
フロントエンド:
pnpm testRust:
cd src-tauri && cargo test
プロジェクト構造
— Rust ベンダー(CLI、ファイル I/O、ファイルウォッチング、フォルダーレジストリ、ファジー検索)src-tauri/
— React フロントエンド(Markdown パイプライン、UI コンポーネント、テーマ)src/
— アプリコンポーネント(ビューア、サイドバー、コマンドパレットなど)src/components/
— shadcn/ui のプライムティブ(基盤コンポーネント)src/components/ui/
— コアロジック(markdown-it 設定、Shiki、Tauri IPC ラッパー)src/lib/
— Tailwind ベースおよび Markdown Prose スタイルsrc/styles/
— インストール補助スクリプトscripts/
採用されている技術
| レイヤー | テクノロジー |
|---|---|
| デスクトップシェル | Tauri v2 |
| フロントエンド | React + TypeScript + Vite |
| Markdown | markdown-it |
| シンタックスハイライト | Shiki |
| 数式 | KaTeX |
| 図 | Mermaid |
| ファジー検索 | nucleo |
| UI プライムティブ | shadcn/ui |
| スタイル | Tailwind CSS |
| ファイルウォッチング | notify |
ロードマップ
- x86 と Linux のサポート — 現在は macOS ARM 専用ですが、x86 マクロと Linux への展開を進めています。
- 組み込み AI チャット — Markdown ドキュメント内から直接 Claude Code や Codex とチャットできます。
- Git.diff リビュー — アプリを離れることなくローカルの Git ダイクを検証・レビューできます。
コントリビューションの依頼
オープンソースコミュニティを学び、インスピレーションを受け、創造するための素晴らしい場所にしてくれるのはコントリビューションです。どのような貢献も大歓迎です。
プロセス
- プロジェクトをフォークします
- 機能ブランチを作成します:
git checkout -b feature/AmazingFeature - 変更をコミットします:
git commit -m 'Add some AmazingFeature' - ブランチにプッシュします:
git push origin feature/AmazingFeature - プルリクエストを開きます
PR を送付する前に:
およびpnpm test
を実行してくださいcd src-tauri && cargo test
を実行してくださいpnpm typecheck- 実際には
で Markdown ファイルを開き、正しくレンダリングされるか確認してくださいpnpm tauri dev