{"id":21320429,"url":"https://github.com/kurusugawa-computer/markdown-copilot-vscode","last_synced_at":"2025-07-12T04:32:47.487Z","repository":{"id":223464236,"uuid":"755439336","full_name":"kurusugawa-computer/markdown-copilot-vscode","owner":"kurusugawa-computer","description":"OpenAI ChatGPT API client for VSCode","archived":false,"fork":false,"pushed_at":"2024-08-19T11:12:19.000Z","size":4261,"stargazers_count":8,"open_issues_count":10,"forks_count":2,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-08-20T10:38:21.401Z","etag":null,"topics":["markdown","openai","vscode-extension"],"latest_commit_sha":null,"homepage":"https://marketplace.visualstudio.com/items?itemName=kurusugawa-computer.markdown-copilot","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kurusugawa-computer.png","metadata":{"files":{"readme":"README.ja.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-10T07:48:28.000Z","updated_at":"2024-08-11T12:22:15.000Z","dependencies_parsed_at":"2024-03-13T19:28:17.311Z","dependency_job_id":"fc09b39e-4167-4bef-83db-0be5207d3c4e","html_url":"https://github.com/kurusugawa-computer/markdown-copilot-vscode","commit_stats":null,"previous_names":["kurusugawa-computer/markdown-copilot-vscode"],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kurusugawa-computer%2Fmarkdown-copilot-vscode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kurusugawa-computer%2Fmarkdown-copilot-vscode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kurusugawa-computer%2Fmarkdown-copilot-vscode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kurusugawa-computer%2Fmarkdown-copilot-vscode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kurusugawa-computer","download_url":"https://codeload.github.com/kurusugawa-computer/markdown-copilot-vscode/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225795392,"owners_count":17525316,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["markdown","openai","vscode-extension"],"created_at":"2024-11-21T19:47:49.949Z","updated_at":"2025-07-12T04:32:47.475Z","avatar_url":"https://github.com/kurusugawa-computer.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![en](https://img.shields.io/badge/English-blue.svg?style=flat-square)](https://github.com/kurusugawa-computer/markdown-copilot-vscode/blob/main/README.md) [![ja](https://img.shields.io/badge/日本語-red.svg?style=flat-square)](https://github.com/kurusugawa-computer/markdown-copilot-vscode/blob/main/README.ja.md) [![zh-cn](https://img.shields.io/badge/简体中文-green.svg?style=flat-square)](https://github.com/kurusugawa-computer/markdown-copilot-vscode/blob/main/README.zh-cn.md)\n# Markdown Copilot for Visual Studio Code\n\n[![Version](https://img.shields.io/visual-studio-marketplace/v/kurusugawa-computer.markdown-copilot.svg?style=flat-square\u0026label=vscode%20marketplace)](https://marketplace.visualstudio.com/items?itemName=kurusugawa-computer.markdown-copilot)\n[![Downloads](https://img.shields.io/visual-studio-marketplace/d/kurusugawa-computer.markdown-copilot.svg?style=flat-square)](https://marketplace.visualstudio.com/items?itemName=kurusugawa-computer.markdown-copilot)\n[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/kurusugawa-computer/markdown-copilot-vscode/release.yml?style=flat-square)](https://github.com/kurusugawa-computer/markdown-copilot-vscode/actions)\n[![GitHub stars](https://img.shields.io/github/stars/kurusugawa-computer/markdown-copilot-vscode.svg?style=flat-square\u0026label=github%20stars)](https://github.com/kurusugawa-computer/markdown-copilot-vscode)\n[![GitHub Contributors](https://img.shields.io/github/contributors/kurusugawa-computer/markdown-copilot-vscode.svg?style=flat-square)](https://github.com/kurusugawa-computer/markdown-copilot-vscode/graphs/contributors)\n\n\n**Markdown Copilot** はVSCode用のOpenAI ChatGPT APIクライアントです。\n\n\u003cimg src=\"https://github.com/kurusugawa-computer/markdown-copilot-vscode/raw/main/images/markdown-copilot.gif\" alt=\"基本的な使用方法\" width=\"1024\"\u003e\n\nMarkdown Copilotを使用すると、OpenAI ChatGPT WebUIを完全に置き換えることができ、次のような優れた機能を提供します:\n1. Model Context Protocolサーバを利用する\n2. 会話履歴をMarkdownで保存する\n3. 複数の会話を同時並行で行う\n4. 会話を分岐させる\n5. 会話履歴を編集して会話を続ける\n6. 会話をもとにファイルに名前をつける\n7. 会話にタイトルをつける\n8. クリップボードの内容をファイルタイプに基づいて賢く貼り付ける\n\n***注意***: この拡張機能を使用するには、OpenAI, Azure OpenAI, OpenRouterまたはローカルのOllamaインスタンスが必要です。設定方法：\n- [OpenAI APIキー](https://help.openai.com/en/articles/4936850-where-do-i-find-my-api-key)\n- [Azure OpenAI クイックスタート](https://learn.microsoft.com/en-us/azure/ai-services/openai/quickstart)\n- [OpenRouter APIキー](https://openrouter.ai/keys): OpenAI, Claude, Gemini, Llama 3などをサポートしています。\n- [ローカルOllamaインスタンス](https://ollama.com/): Llama 3.3, DeepSeek-R1, Phi-4, Mistral, Gemma 2などのモデルをローカルでサポートしています。\n\n## 🌟 主な機能\n\n### ⚡ Model Context Protocolサーバ利用\n\nMarkdown Copilotはオーバーライドツールで[Model Context Protocol(MCP)サーバ](https://github.com/modelcontextprotocol/servers)と連携して機能を拡張できます。\nMCPサーバを介して外部ツールやデータソースにアクセスできるようにすることで、より強力で的確な会話を可能にします。\n\nオーバーライドツールを使用するには、希望する設定を含むJSONコードブロックを `json copilot-tools` として含め、このブロックとテキストを一緒に選択し、コードアクションの提案から `💡 Markdown Copilot: 続ける` を使用します。\n\n**例:** オーバーライドツールを使用して利用可能なツールを列挙する\n\n~~~markdown\nあなたが使えるツールを全て列挙して。\n\n```json copilot-tools\n[\"^copilot\"]\n```\n~~~\n\nMCPサーバの追加方法については、[Use MCP servers in VSCode: Add an MCP server](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server)を参照してください。\n\n### 🔀 並行編集\n\n複数の自動編集を同時に実行し、ひとつの編集が完了するのを待たずに別の編集を開始できるため、作業速度が向上します。\n\n\u003cimg src=\"https://github.com/kurusugawa-computer/markdown-copilot-vscode/raw/main/images/parallel-editing.gif\" alt=\"並行編集\" width=\"1024\"\u003e\n\n### 📝 コンテキストに基づく編集\n\nMarkdown Copilotはコンテキストに基づいて選択したテキストに回答します。\n\n使用するには、テキスト範囲を選択し、コードアクションの提案から `💡 Markdown Copilot: 続ける` を使用します。\n\n\u003cimg src=\"https://github.com/kurusugawa-computer/markdown-copilot-vscode/raw/main/images/contextual-editing.png\" alt=\"コンテキストに基づく編集\" width=\"356\"\u003e\n\nまたは、クイックアクセスのためのショートカットキーを使用します:\n\n|      コマンド       |         Windows / Linux          |              Mac              |\n| :----------------: | :------------------------------: | :---------------------------: |\n| `候補をトリガー`    | \u003ckbd\u003eCtrl\u003c/kbd\u003e+\u003ckbd\u003eSpace\u003c/kbd\u003e または \u003ckbd\u003eCtrl\u003c/kbd\u003e+\u003ckbd\u003eI\u003c/kbd\u003e | \u003ckbd\u003e⌃\u003c/kbd\u003e+\u003ckbd\u003eSpace\u003c/kbd\u003e または \u003ckbd\u003e⌘\u003c/kbd\u003e+\u003ckbd\u003eI\u003c/kbd\u003e |\n\n\u003cimg src=\"https://github.com/kurusugawa-computer/markdown-copilot-vscode/raw/main/images/contextual-editing-shortcut.png\" alt=\"コンテキストに基づく編集のショートカット\" width=\"442\"\u003e\n\n### ᝰ オーバーライドオプション\n\nMarkdown Copilotの挙動をオーバーライドオプションでカスタマイズします。これにより、文書内で直接、応答の長さやAIモデルなどの設定をコントロールできます。\n\nオーバーライドオプションを使用するには、希望する設定を含むJSONまたはYAMLコードブロックをそれぞれ `json copilot-options` または `yaml copilot-options` として含め、このブロックとテキストを一緒に選択し、コードアクションの提案から `💡 Markdown Copilot: 続ける` を使用します。\n\n**例:** カスタマイズされた応答の長さとモデルでMarkdown Copilotに自己紹介させる (JSON)\n\n~~~markdown\n自己紹介してください。\n\n```json copilot-options\n{\"max_tokens\":50,\"model\":\"gpt-3.5-turbo\"}\n```\n~~~\n\n**例:** カスタマイズされた応答の長さとモデルでMarkdown Copilotに自己紹介させる (YAML)\n\n~~~markdown\n自己紹介してください。\n\n```yaml copilot-options\nmax_tokens: 50\nmodel: gpt-3.5-turbo\n```\n~~~\n\n**例:** `o1-preview` モデルを利用する (JSON)\n\n`o1-preview` モデルはシステムメッセージをサポートしていないので `**System(Override):**` を使ってシステムメッセージを空にします。\n\n~~~markdown\n**System(Override):**\n\n**User:**\n自己紹介してください。\n\n```json copilot-options\n{\"model\":\"o1-preview\",\"temperature\":1}\n```\n~~~\n\n**例:** ローカル Ollama の `llama2` モデルを使用する (JSON)\n~~~markdown\nIntroduce yourself.\n\n```json copilot-options\n{\"model\":\"llama2\",\"baseURL\":\"http://localhost:11434/v1\"}\n```\n~~~\n\n**例:** ローカル Ollama の `llama2` モデルを使用する (YAML)\n~~~markdown\nIntroduce yourself.\n\n```yaml copilot-options\nmodel: llama2\nbaseURL: http://localhost:11434/v1\n```\n~~~\n\n他の設定オプションについては、[OpenAI API: Create chat completion](https://platform.openai.com/docs/api-reference/chat/create)を参照してください。\n\n### 📛 ファイルに名前をつけて保存\n\nMarkdown Copilotはファイル内容をもとにファイルに名前を付けて保存できます。\n\n使用するには、ファイルに名前を付けて保存したいエディタを選択して`Markdown Copilot: 名前をつけて保存...`コマンドを使用します。\n\nまたは、次のショートカットキーを使用します:\n\n| Windows / Linux | Mac |\n| :-------------: | :---: |\n| \u003ckbd\u003eCtrl\u003c/kbd\u003e+\u003ckbd\u003eShift\u003c/kbd\u003e+\u003ckbd\u003eP\u003c/kbd\u003e \u003e \u003ckbd\u003eName and Save As\u003c/kbd\u003e | \u003ckbd\u003e⌘\u003c/kbd\u003e+\u003ckbd\u003e⇧\u003c/kbd\u003e+\u003ckbd\u003eP\u003c/kbd\u003e \u003e \u003ckbd\u003eName and Save As\u003c/kbd\u003e |\n\n### 🏷️ アクティブコンテキストにタイトルを付ける\n\nMarkdown Copilotは会話履歴をもとに会話にタイトルを付けられます。\n会話タイトルは`# Copilot Context: `で始まる行として表現します。\n\n使用するには、タイトルを付けたいコンテキストにカーソルを移動して`Markdown Copilot: アクティブコンテキストにタイトルを付ける`コマンドを使用します。\n\nまたは、次のショートカットキーを使用します:\n\n| Windows / Linux | Mac |\n| :-------------: | :---: |\n| \u003ckbd\u003eCtrl\u003c/kbd\u003e+\u003ckbd\u003eShift\u003c/kbd\u003e+\u003ckbd\u003eP\u003c/kbd\u003e \u003e \u003ckbd\u003eTitle active context\u003c/kbd\u003e | \u003ckbd\u003e⌘\u003c/kbd\u003e+\u003ckbd\u003e⇧\u003c/kbd\u003e+\u003ckbd\u003eP\u003c/kbd\u003e \u003e \u003ckbd\u003eTitle active context\u003c/kbd\u003e |\n\n### 🪄 要約と新しいコンテキスト\nMarkdown Copilotでは現在のコンテキストを要約し、その要約に基づいて新しいコンテキストを開始できます。\nこの機能により、会話のコンテキストが長くなりすぎてモデルの処理能力を阻害しないようにしつつ、会話の要点を把握しやすくなります。\n\n使用するには、要約したいコンテキストにカーソルを合わせた上で `Markdown Copilot: コンテキストを要約して新規開始` コマンドを使用してください。\n\n| Windows / Linux | Mac |\n| :-------------: | :---: |\n| \u003ckbd\u003eCtrl\u003c/kbd\u003e+\u003ckbd\u003eShift\u003c/kbd\u003e+\u003ckbd\u003eP\u003c/kbd\u003e \u003e \u003ckbd\u003eSummarize and New Context\u003c/kbd\u003e | \u003ckbd\u003e⌘\u003c/kbd\u003e+\u003ckbd\u003e⇧\u003c/kbd\u003e+\u003ckbd\u003eP\u003c/kbd\u003e \u003e \u003ckbd\u003eSummarize and New Context\u003c/kbd\u003e |\n\n### 📋⤵ いい感じのテキストとして貼り付ける\n\nMarkdown Copilotはクリップボードの内容をファイルタイプに応じて賢くドキュメントに貼り付けることができます。\nこの機能により、貼り付けた内容が編集中のファイルにシームレスに統合され、不要なフォーマットの問題を回避できます。\n\n使用するには、貼り付けたい場所を選択し`Markdown Copilot: Paste as Pretty Text`コマンドを使用します。\n\nまたは、次のショートカットキーを使用します:\n\n| Windows / Linux | Mac |\n| :-------------: | :---: |\n| \u003ckbd\u003eCtrl\u003c/kbd\u003e+\u003ckbd\u003eShift\u003c/kbd\u003e+\u003ckbd\u003eP\u003c/kbd\u003e \u003e \u003ckbd\u003ePaste as pretty\u003c/kbd\u003e | \u003ckbd\u003e⌘\u003c/kbd\u003e+\u003ckbd\u003e⇧\u003c/kbd\u003e+\u003ckbd\u003eP\u003c/kbd\u003e \u003e \u003ckbd\u003ePaste as pretty\u003c/kbd\u003e |\n\n### 📥 他のMarkdownファイルをインポート\n\nMarkdown Copilotは他のMarkdownファイルを現在の文書に簡単にインポートできます。\nこれにより、他のドキュメントの内容を参照したり、再利用したりすることが可能になります。\n\n他のMarkdownファイルをインポートするには、`@import`ディレクティブを使用します。\nこのディレクティブに続けて、インポートしたいファイルのパスをダブルクォーテーションで囲んで指定します。\n\n**相対パスの例:**　現在のファイルから相対的な位置にある`another-markdown.md`をインポートします。\n\n```markdown\n@import \"path/to/another-markdown.md\"\n```\n\n**絶対パスの例:**　ワークスペースのルートディレクトリからの絶対パスを使用して`toplevel-markdown.md`をインポートします。\n\n```markdown\n@import \"/toplevel-markdown.md\"\n```\n\n現在の文書が未保存ときはファイルパスが確定していないため、必ず絶対パスを使用して他のMarkdownファイルを指定する必要があります。\n\n### 🎛 コンテキストコントロール\n\nコンテキストインデントと構文カラーを使用して、会話のコンテキストを階層的に管理し、視覚的にコンテキストを強調表示します。\n\n\u003cimg src=\"https://github.com/kurusugawa-computer/markdown-copilot-vscode/raw/main/images/context-switching.gif\" alt=\"コンテキストコントロール\" width=\"1024\"\u003e\n\n#### ♯ Markdownにおけるコンテキスト表記\n\nアクティブなコンテキストは、カーソル行からコンテキストインデントを遡って決定されます。\n`# Copilot Context`で始まる行でコンテキストガードを強制できます。\n\n\u003cimg src=\"https://github.com/kurusugawa-computer/markdown-copilot-vscode/raw/main/images/context-notation-example-takecare.png\" alt=\"例: take care\" width=\"512\"\u003e\n\n`Then say \"take care\".`を選択して`💡 Markdown Copilot: 続ける` を使用すると、次の出力が得られます: `hello` → `good bye` → `take care`。\n\n\u003cimg src=\"https://github.com/kurusugawa-computer/markdown-copilot-vscode/raw/main/images/context-notation-example-takecare-result.gif\" alt=\"例: take care\" width=\"460\"\u003e\n\n**より複雑な例:** コンテキストは`take care`行を跨いで継続します。\n\n\u003cimg src=\"https://github.com/kurusugawa-computer/markdown-copilot-vscode/raw/main/images/context-notation-example-seeyouagain.png\" alt=\"例: see you again\" width=\"512\"\u003e\n\n**発言者の指定:** 行頭に特定のMarkdown表記を配置することで発言者を指定できます。\n\n| Markdown | 意味 |\n| -------- | ---- |\n| `**User:**` | ユーザ自身の発言であることを指定します |\n| `**Copilot:**` | Markdown Copilotの発言であることを指定します |\n| `**System(Override):**` | [システムメッセージ](https://platform.openai.com/docs/guides/prompt-engineering/tactic-ask-the-model-to-adopt-a-persona)を上書き指定します |\n| `**System:**` | 追加の[システムメッセージ](https://platform.openai.com/docs/guides/prompt-engineering/tactic-ask-the-model-to-adopt-a-persona)を指定します |\n\n\n#### ⤷ コンテキストインデント\n\nコンテキストインデントレベルの編集を直感的なアクションで行えます。\n\nテキストを選択し、コードアクションの提案から `💡 Markdown Copilot: コンテキスト行をインデント` または `💡 Markdown Copilot: コンテキスト行をアウトデント` を選択します。\n\n\u003cimg src=\"https://github.com/kurusugawa-computer/markdown-copilot-vscode/raw/main/images/quote-indentation.gif\" alt=\"コンテキストインデント\" width=\"512\"\u003e\n\nまたは、次のショートカットキーを使用します:\n\n|       コマンド        |                       Windows / Linux                        |                         Mac                         |\n| :------------------: | :----------------------------------------------------------: | :-------------------------------------------------: |\n| `Indent Quote Line`  |         \u003ckbd\u003eCtrl\u003c/kbd\u003e+\u003ckbd\u003eAlt\u003c/kbd\u003e+\u003ckbd\u003eL\u003c/kbd\u003e          |       \u003ckbd\u003e⌘\u003c/kbd\u003e+\u003ckbd\u003e⌥\u003c/kbd\u003e+\u003ckbd\u003eL\u003c/kbd\u003e        |\n| `Outdent Quote Line` | \u003ckbd\u003eCtrl\u003c/kbd\u003e+\u003ckbd\u003eAlt\u003c/kbd\u003e+\u003ckbd\u003eShift\u003c/kbd\u003e+\u003ckbd\u003eL\u003c/kbd\u003e | \u003ckbd\u003e⌘\u003c/kbd\u003e+\u003ckbd\u003e⌥\u003c/kbd\u003e+\u003ckbd\u003e⇧\u003c/kbd\u003e+\u003ckbd\u003eL\u003c/kbd\u003e |\n\n\u003cimg src=\"https://github.com/kurusugawa-computer/markdown-copilot-vscode/raw/main/images/quote-indentation-shortcut.gif\" alt=\"コンテキストインデントのショートカット\" width=\"512\"\u003e\n\n## 📋 前提条件\n\n- OpenAI APIまたはAzure OpenAI Serviceへのアクセスが必要です。詳細については、[OpenAI API](https://openai.com/blog/openai-api)または[Azure OpenAIクイックスタート](https://learn.microsoft.com/ja-jp/azure/ai-services/openai/quickstart)をご覧ください。\n- Visual Studio Codeがインストールされている必要があります。[Visual Studio Codeダウンロードページ](https://code.visualstudio.com/Download)からダウンロードしてください。\n\n## 🔌 Markdown体験を強化する\n\n次の拡張機能とMarkdown Copilotを組み合わせて、さらに強力なMarkdown体験を実現します:\n- **[Markdown All in One]**:\n  包括的なMarkdownサポート(キーボードショートカット、目次、自動プレビューなど)。\n- **[Snippets]**:\n  VS Codeでスニペットを過給 - エディタを終了せずにコードスニペットを管理できます。\n- **[Markdown Preview Mermaid Support]**:\n  VS Codeの組み込みmarkdownプレビューにMermaidダイアグラムとフローチャートのサポートを追加します。\n- **[Markdown Preview Enhanced]**:\n  Markdown Preview Enhanced は Visual Studio Code のスーパー強力なmarkdown 拡張機能です。 このプロジェクトの目標は、素晴らしい markdown 編集経験を提供することです。\n- **[Markdown+Math]**:\n  LaTeX Mathを使用してMarkdownを強化します...マクロなどを含む。\n\n## 🔄 変更履歴\n詳細な更新については、[CHANGELOG](CHANGELOG.md)を参照してください。\n\n## 🤝 参加する\n- [GitHub Issues](https://github.com/kurusugawa-computer/markdown-copilot-vscode/issues)を通じてバグを報告したり、機能を提案してください。\n- [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=kurusugawa-computer.markdown-copilot#review-details)でレビューを残してフィードバックを共有してください。\n\n\n[Markdown All in One]: https://marketplace.visualstudio.com/items?itemName=yzhang.markdown-all-in-one\n[Snippets]: https://marketplace.visualstudio.com/items?itemName=tahabasri.snippets\n[Markdown Preview Mermaid Support]: https://marketplace.visualstudio.com/items?itemName=bierner.markdown-mermaid\n[Markdown Preview Enhanced]: https://marketplace.visualstudio.com/items?itemName=shd101wyy.markdown-preview-enhanced\n[Markdown+Math]: https://marketplace.visualstudio.com/items?itemName=goessner.mdmath\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkurusugawa-computer%2Fmarkdown-copilot-vscode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkurusugawa-computer%2Fmarkdown-copilot-vscode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkurusugawa-computer%2Fmarkdown-copilot-vscode/lists"}