ホームに戻る

Markdown Reader ヘルプ

3分ですべての機能を理解

クイックスタート ショートカット 機能詳細 テーマと外観 図表と数式 CLI ツール Quick Look PDF 書き出し よくある質問

クイックスタート

ファイルを開いて読み始める — それだけです

1. ファイルまたはフォルダを開く

⌘O でファイルを選択するか、⇧⌘N で新しい独立ウィンドウを開きます。ドラッグ&ドロップにも対応。

2. 読書とスムーズな切替

左側にファイルツリー、中央にコンテンツ、右側にアウトライン。⇧⌘E / ⇧⌘R で閲覧位置を失わずにレンダリングとソースを相互切替。

3. 編集と行番号

ソースモードで直接編集し、⌘S で保存。設定で行番号を有効にすると長文編集も快適。

4. ファイルを素早く開く

⌘P でコマンドパレットを開き、ファイル名を入力して検索、↑↓ で選択、Enter で開きます。

ショートカット一覧

キーボードでより効率的に

ショートカット機能
⌘N新規ファイル
⇧⌘N新規ウィンドウ
⌘Oフォルダ / ファイルを開く
⌘Sファイルを保存
⇧⌘S別名で保存
⌥⌘EPDF 書き出し
⌘Wウィンドウを閉じる
⌘,設定を開く
⌘\サイドバー切替
⇧⌘Eレンダリングモード
⇧⌘Rソースモード
⌘+拡大
⌘-縮小
⌘0実際のサイズ
⌘F検索
⌘G次を検索
⇧⌘G前を検索
⌥⌘F検索と置換
⌘Pコマンドパレット
⌘?ヘルプ

機能詳細

すべては読書体験の向上のために

レンダリングビュー

cmark-gfm で Markdown を解析し、WebPage(macOS 26 ネイティブ)でレンダリング。テーブル、タスクリスト、取り消し線、自動リンクなどの完全な GFM 拡張に対応。

スムーズなモード切替

小数点ソースアンカーパイプライン(SourceScrollAnchor)により、レンダリングモードとソースモードの切り替え時にも閲覧位置を正確に維持。ジャンプや白画面がありません。

ソース編集と行番号

⇧⌘R で Markdown ソースを直接編集。Prism.js による 30+ 言語ハイライト。外観設定でエディタ行番号(Gutter)を表示可能(幅自動調整・安定スクロール)。

ネイティブマルチウィンドウ

⇧⌘N で独立ウィンドウを新規作成。複数の文書やディレクトリを並行して開け、独立した編集状態と Undo スタックを保持します。

スマートファイルツリー

フォルダの再帰閲覧、ディレクトリシンボリックリンクの完全サポート、外部変更のリアルタイム検知。「単一ファイルオープン時に同一フォルダを自動展開」にも対応。

アウトラインナビゲーション

見出し階層を自動抽出し、クリックするとスムーズスクロールで上部約12ptに統一配置。長文の閲覧に便利。

検索と置換

⌘F で検索バーを開きます。大文字小文字の区別、完全一致、正規表現に対応。⌥⌘F で検索と置換を開きます。

ビューの拡大・縮小

⌘+ / ⌘- でズーム(0.3x〜3.0x)。⌘0 で原寸大に戻せます。ズーム倍率は自動記憶。

コマンドパレット

⌘P でコマンドパレットを開き、ファジーマッチでファイルツリー内のファイルを検索・キーボードで素早く開けます。

テーマと外観

33 テーマで読書空間をカスタマイズ

テーマモード

設定 → 外観 で、ライト・ダーク・システム追従の3モードから選択可能。即座に外観が切り替わります。

カラーパレット

33 のプリセット配色(20 ダーク + 13 ライト)— Dracula、Catppuccin、Nord、Tokyo Night… 各モード独立設定。

カスタムカラー

設定 → 外観 → カスタムカラー で、背景色、文字色、アクセント色、成功色、危険色を個別に微調整可能。

コントラスト調整

低/高の2段階コントラスト設定で、背景と前景レイヤーの視覚的メリハリを調整できます。

図表と数式

技術文書の完璧な描画

デュアル図表エンジン (Mermaid / Pele)

コードブロックで `mermaid` 識別子を使用。一般設定でエンジンを切り替え可能:定番の Mermaid.js レイアウト、またはアプリテーマと連動する軽量 Pele SVG エンジン。完全ローカル描画。

数式 (KaTeX)

インライン数式は `$...$`、ブロック数式は `$$...$$` で囲みます。数式を含む文書でのみオンデマンドでライブラリをロード。

PlantUML 図表

コードブロックで `plantuml` を指定すると SVG として自動描画(ネットワーク接続が必要)。

CLI ツール mdr

ターミナルワークフローに統合

インストール

設定 → 一般 → コマンドラインツール のスイッチをオンにするだけでインストール完了。ターミナルですぐに `mdr` が使えます。

使い方

ターミナルで `mdr README.md` と入力するだけ。複数のファイルやフォルダの同時オープンにも対応。

その他の機能

読書を支える細やかな工夫

Quick Look プレビュー

Finder で .md ファイルを選択しスペースキーでプレビュー。設定 → 一般 → Quick Look プレビュー で有効化。

文書をワンクリックでコピー

レンダリング、ソース、Quick Look のいずれからも全文をワンクリックコピー。設定で一括オフ可能。リッチテキストまたは Markdown 原文を選択。

PDF 書き出し

⌥⌘E または ファイル → PDF 書き出し で、現在のテーマスタイルを保持したまま PDF 保存。

よくある質問

お困りですか?まずこちらをチェック

対応しているファイル形式は?

`.md`、`.markdown`、`.mdown`、`.mkd` などの Markdown 形式ファイルに対応しています。

動作環境は?

macOS 26 (Tahoe) 以降。Apple Silicon にネイティブ対応しています。

Homebrew でのインストールとアップグレード方法は?

`brew tap davidhoo/markdownreader && brew install --cask markdownreader` でインストールできます。アップグレード時は `brew upgrade --cask --greedy markdownreader` を実行してください。

初回起動時に開けない、または未署名の警告が出る場合は?

MarkdownReader は開発者署名済みのオープンソースアプリですが、Apple Developer の有償公証は受けていません。Gatekeeper でブロックされた場合は、Finder のアプリケーションフォルダでアプリを Control キーを押しながらクリックして「開く」を選択するか、「システム設定 > プライバシーとセキュリティ」から「このまま開く」をクリックしてください。

PlantUML 図表が表示されない?

PlantUML 描画にはサーバーへのネットワーク接続が必要です。オフライン環境でも Mermaid / Pele 図表は完全ローカルで描画されます。

Markdown Reader をデフォルトアプリに設定するには?

設定 → 一般 → デフォルト Markdown アプリ で「デフォルトに設定」をクリック。または .md ファイルの情報ウィンドウ(⌘I)から変更できます。

フィードバックや不具合報告はどこへ?

GitHub Issues でのフィードバックや Pull Request を歓迎しています。