showmd

showmd：macOSでMarkdownを最適にプレビューするための究極ツール

macOSでMarkdownファイルをプレビューする際、標準のQuick Look（クイックルック）では記号だらけの生テキストが表示され、内容を把握しにくいと感じたことはありませんか？ showmd は、その問題を解決するために開発された、macOSネイティブのMarkdownビューアです。

Markdownは本来、プレーンテキストとして閲覧されるために作られたものではありません。showmd を導入することで、あなたのMac上にあるすべてのMarkdownファイルが、GitHubのように美しく、読みやすい形式で瞬時にレンダリングされるようになります。

What's showmd (showmdとは)

showmd は、macOS専用の高速かつ軽量なMarkdownプレビュー拡張機能です。Finderでファイルを選択してスペースキーを押すだけで、構造化された美しいドキュメントを表示します。

単なるビューアではなく、現代的なMarkdownの利用シーン（AIプロンプト、データ解析、技術文書）に特化しているのが特徴です。オープンソースであり、完全に無料で提供されています。エディタやノートアプリではないため、余計な機能や重さは一切なく、純粋に「読むこと」に特化しています。

showmdの主な特徴 (Features)

showmd は、他のプレビューツールとは一線を画す強力な機能を備えています。

1. 現代的なMarkdown要素への対応

• YAMLフロントマターのレンダリング: ファイル冒頭のメタデータ（---で囲まれた部分）を解析し、折りたたみ可能なテーブルとして表示します。デフォルトでは折りたたまれており、ワンクリックで展開可能です。
• エージェントAI XMLタグの可視化: <instructions>、<example>、<thinking> など、AIプロンプトで使用される20種類以上のカスタムXMLタグを、枠線付きのラベル付きブロックとしてレンダリングします。
• GitHubスタイルのアラート: NOTE、TIP、IMPORTANT、WARNING、CAUTIONなどのコールアウトを、色付きの境界線とアイコンで表示します。

2. 高度な技術文書のサポート

• LaTeX数式: KaTeXを利用し、インライン $x^2$ やブロック形式 $$...$$ の数式を美しく表示します。
• Mermaid図表: フローチャートやシーケンス図などをコードブロックから直接レンダリングします。
• 構文ハイライト: 190以上の言語に対応したコードブロックのハイライト表示が可能です。

3. macOSに最適化されたUX

• 高速起動: 1秒以内に開き、Finderの操作を妨げません。
• ダークモード対応: システム設定に自動追従し、ライト/ダークの切り替えも可能です。
• フルGFMサポート: テーブル、タスクリスト、打ち消し線、自動リンクなどのGitHub Flavored Markdownに完全対応しています。

4. プライバシーとセキュリティ

• オフライン動作: クラウドへのアップロードやテレメトリ（データ収集）は一切ありません。ファイルがマシン外に出ることはなく、プライバシーが守られます。

showmdの使用シーン (Use Case)

• 開発ドキュメントの確認: README.mdやCHANGELOG.mdを、IDEを開かずにFinderからサッと確認したいとき。
• AI設定ファイルの閲覧: AGENTS.mdや.cursorrulesなど、複雑なXMLタグが含まれるAI関連ファイルを整理された状態で読みたいとき。
• 数式や図表のチェック: 論文の下書きや技術仕様書に含まれるLaTeX数式やMermaid図が正しく記述されているか確認するとき。
• HTMLへの変換: プレビュー画面からワンクリックで「HTMLとしてコピー」し、他のドキュメントに貼り付けたいとき。

showmdの導入方法 (How to Use)

インストールから使用開始までの手順は非常に簡単です。

1. ダウンロードとインストール:
   • 公式サイトから showmd-1.0.1.dmg をダウンロードするか、Homebrewを使用してインストールします。
   • brew install --cask johannesnagl/tap/showmdを実行してください。
2. システム設定での有効化:
   • アプリを一度開いた後、「システム設定」→「プライバシーとセキュリティ」→「拡張機能」→「Quick Look」へ進みます。
   • showmd のチェックボックスをオンにします。
3. Finderでプレビュー:
   • .md、.mdx、.markdownなどのファイルを選択し、スペースキーを押すだけでレンダリングされた表示が開始されます。

よくある質問 (FAQ)

Q: showmdは有料ですか？ A: いいえ、完全に無料のオープンソースソフトウェア（MITライセンス）です。

Q: 編集機能はありますか？ A: いいえ、showmd は純粋なビューアです。読み取り専用で開き、レンダリングすることに特化しています。

Q: 元のソースコードを確認することはできますか？ A: はい。プレビュー画面上部の「Rendered / Source」トグルボタンで、レンダリング表示と生のMarkdownテキストをいつでも切り替えられます。

Q: どのようなファイル拡張子に対応していますか？ A: .md, .markdown, .mdx, .mdc, .rmd, .qmd, .mdown, .mkd, .mkdn など、ほぼすべてのMarkdown拡張子を自動で認識します。

---

showmd を使って、あなたのMacでのMarkdown体験をアップグレードしましょう。