GoMind Viewer for VS Code

Preview structured files as clear, navigable mind maps without leaving VS Code.

GoMind Viewer supports Markdown, YAML, XMind workbooks, and GoMind files. Open a file from the editor or Explorer, choose the matching Preview ... with GoMind command, and the viewer opens beside your document.

English · 简体中文 · 日本語

English

Features

• Preview .md, .markdown, .yaml, .yml, .xmind, and .gomind files as mind maps.
• Open a preview from the editor context menu, Explorer context menu, or Command Palette.
• Refresh the preview automatically when the source file is saved.
• Keep the preview beside your source document for an efficient read-and-edit workflow.
• Serve the currently viewed file through a local loopback server; the offline preview does not upload your files to a remote service.
• Pick a file to preview directly from the GoMind sidebar, without opening it in the editor first.
• Open the online GoMind web app in an editor tab or in your browser from the sidebar. Requires an internet connection.

GoMind sidebar

The GoMind icon in the Activity Bar opens a lightweight entry page. Choose Select a file to preview to pick a Markdown, YAML, XMind, or GoMind file from disk and open it in the viewer, Open in editor to load the online web app in an editor tab for a wider canvas, or Open in browser when you need a separate browser window for sign-in or compatibility.

When the active editor contains a supported file, a Preview button appears above Select a file to preview so the current document opens with one click.

Below the entry buttons, Previewable Files lists the matching files in the current workspace. Select any entry to preview it, or use the refresh action in the view title. The view opens as a flat list by default; use the list/tree action in the view title to switch between a flat list and the workspace folder structure. The choice is remembered per workspace. The list is hidden when the workspace has no matching files.

The online web app is loaded from https://gomind.app/app/ by default. Set gomind.app.region to mainland to use https://gomindapp.com/app/. The extension does not send local preview files, file tokens, or credentials to the online app.

Quick start

1. Install GoMind Viewer.
2. Open a supported file in VS Code.
3. Right-click the file and choose the matching Preview ... with GoMind command, or run it from the Command Palette (Cmd/Ctrl+Shift+P).
4. Edit and save the file. The preview refreshes automatically by default.
5. To preview a file without opening it, select the GoMind icon in the Activity Bar and choose Select a file to preview.
6. To use the online app, select the GoMind icon in the Activity Bar, then choose Open in editor or Open in browser.

Supported formats

Settings

• gomind.viewer.enableAutoRefresh — Refresh the preview when the source file is saved. Default: true.
• gomind.viewer.serverHost — Local server bind host. Default: 127.0.0.1.
• gomind.app.region — Online app entry point: global (default, gomind.app) or mainland (gomindapp.com).

Privacy and security

The offline preview runs a temporary HTTP server on 127.0.0.1 and gives the viewer a short-lived, random access token for the file currently being previewed. It does not intentionally send your document to GoMind or another remote server.

The online GoMind web app in the sidebar and editor is different: it loads from GoMind's web service over the network, so normal web-service data handling applies. The extension does not pass local file paths, preview tokens, or credentials into the embedded web app.

Requirements

• VS Code 1.85 or newer.

Feedback

If a file does not render as expected, please include the file format, VS Code version, extension version, and a reproducible example when opening an issue. Do not attach confidential documents.

简体中文

功能

• 将 .md、.markdown、.yaml、.yml、.xmind 和 .gomind 文件预览为思维导图。
• 支持编辑器右键菜单、资源管理器右键菜单和命令面板。
• 源文件保存后自动刷新预览。
• 预览窗口可显示在源文件旁边，方便边读边改。
• 当前预览文件通过本机回环地址提供；离线预览不会把文件上传到远程服务。
• 可直接从 GoMind 侧栏选择文件进行预览，无需先在编辑器中打开。
• 可从侧栏在编辑区或浏览器打开在线 GoMind Web 应用，需要联网。

GoMind 侧栏

点击活动栏的 GoMind 图标会打开一个简单的入口页。选择 选择文件进行预览 可从磁盘挑选 Markdown、YAML、XMind 或 GoMind 文件并直接在查看器中打开；需要更宽的画布时选择 在编辑区打开 加载在线 Web 应用；需要单独窗口完成登录或处理兼容性问题时选择 在浏览器打开。

如果当前编辑器中打开的是支持的文件，选择文件进行预览 上方会出现 预览 <文件名> 按钮，一键打开当前文档。

入口按钮下方是 可预览文件 列表，会列出当前工作区中所有支持的文件；点击任意条目即可预览，也可用视图标题栏的刷新按钮重新扫描。该视图默认平铺显示，可用标题栏的列表/树形按钮在平铺列表和文件夹层级之间切换，选择会按工作区记住。工作区里没有符合条件的文件时，列表不显示内容。

在线 Web 应用默认从 https://gomind.app/app/ 加载。将 gomind.app.region 设为 mainland 可改用 https://gomindapp.com/app/。扩展不会把本地预览文件、文件令牌或凭据发送给在线应用。

快速开始

1. 安装 GoMind Viewer。
2. 在 VS Code 中打开支持的文件。
3. 右键文件，选择对应的 Preview ... with GoMind 命令；也可以打开命令面板（Cmd/Ctrl+Shift+P）执行。
4. 编辑并保存文件。默认情况下，预览会自动刷新。
5. 如果不想先在编辑器中打开文件，点击活动栏中的 GoMind 图标，选择 选择文件进行预览。
6. 如需在线应用，点击活动栏中的 GoMind 图标，再选择 在编辑区打开 或 在浏览器打开。

支持的格式

设置

• gomind.viewer.enableAutoRefresh：保存源文件时刷新预览。默认值：true。
• gomind.viewer.serverHost：本地服务器绑定地址。默认值：127.0.0.1。
• gomind.app.region：在线应用入口，global（默认，gomind.app）或 mainland（gomindapp.com）。

隐私与安全

离线预览会在 127.0.0.1 上启动临时 HTTP 服务，并为当前预览文件生成短期、随机的访问令牌。扩展不会主动将文档发送给 GoMind 或其他远程服务器。

侧栏和编辑区中的在线 GoMind Web 应用不同：它会联网加载 GoMind 的 Web 服务，适用相应的 Web 服务数据处理规则。扩展不会把本地文件路径、预览令牌或凭据传入内嵌的 Web 应用。

环境要求

• VS Code 1.85 或更高版本。

反馈

如果文件显示异常，请在 issue 中提供文件格式、VS Code 版本、扩展版本和可复现示例。请不要上传包含敏感信息的文件。

日本語

主な機能

• .md、.markdown、.yaml、.yml、.xmind、.gomind ファイルをマインドマップとしてプレビューできます。
• エディターのコンテキストメニュー、エクスプローラーのコンテキストメニュー、コマンドパレットから開けます。
• ソースファイルを保存すると、プレビューを自動的に更新できます。
• ソースファイルの横にプレビューを表示し、読みながら編集できます。
• 表示中のファイルはローカルのループバックアドレス経由で提供されます。オフラインプレビューがファイルをリモートサービスへアップロードすることはありません。
• GoMind サイドバーからファイルを選択して直接プレビューできます（エディターで開く必要はありません）。
• サイドバーからオンライン GoMind Web アプリをエディタータブまたはブラウザーで開けます。ネットワーク接続が必要です。

GoMind サイドバー

アクティビティバーの GoMind アイコンを選択すると、シンプルなエントリーページが開きます。ファイルを選択してプレビュー で Markdown、YAML、XMind、GoMind ファイルをディスクから選んでビューアーで開けます。広いキャンバスには エディターで開く でオンライン Web アプリをエディタータブに読み込み、サインインや互換性の確認には ブラウザーで開く を使用してください。

アクティブなエディターで対応ファイルを開いている場合、ファイルを選択してプレビュー の上に <ファイル名> をプレビュー ボタンが表示され、ワンクリックで開けます。

エントリーボタンの下には プレビュー可能なファイル リストがあり、現在のワークスペース内の対応ファイルを表示します。項目を選択するとプレビューでき、ビューのタイトルにある更新アクションで再スキャンできます。既定ではフラットなリスト表示で、タイトルのリスト/ツリーボタンでフォルダー階層表示と切り替えられます。選択はワークスペースごとに記憶されます。対象ファイルがない場合はリストに内容が表示されません。

オンライン Web アプリは既定では https://gomind.app/app/ から読み込みます。gomind.app.region を mainland にすると https://gomindapp.com/app/ を使用します。拡張機能はローカルプレビューのファイル、トークン、認証情報をオンラインアプリへ送信しません。

使い方

1. GoMind Viewer をインストールします。
2. VS Code で対応ファイルを開きます。
3. ファイルを右クリックして対応する Preview ... with GoMind を選択します。コマンドパレット（Cmd/Ctrl+Shift+P）からも実行できます。
4. ファイルを編集して保存します。既定ではプレビューが自動更新されます。
5. ファイルを開かずにプレビューするには、アクティビティバーの GoMind アイコンを選択し、ファイルを選択してプレビュー を選びます。
6. オンラインアプリを使うには、アクティビティバーの GoMind アイコンを選択し、エディターで開く または ブラウザーで開く を選びます。

対応形式

設定

• gomind.viewer.enableAutoRefresh：ソースファイルの保存時にプレビューを更新します。既定値：true。
• gomind.viewer.serverHost：ローカルサーバーのバインド先です。既定値：127.0.0.1。
• gomind.app.region：オンラインアプリの入口。global（既定、gomind.app）または mainland（gomindapp.com）。

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

オフラインプレビューは 127.0.0.1 上で一時的な HTTP サーバーを起動し、表示中のファイルに対して短時間だけ有効なランダムトークンを発行します。GoMind やその他のリモートサーバーへドキュメントを意図的に送信することはありません。

サイドバーとエディターのオンライン GoMind Web アプリは別です。GoMind の Web サービスをネットワーク経由で読み込むため、Web サービスのデータ取扱いが適用されます。拡張機能はローカルファイルのパス、プレビュートークン、認証情報を埋め込み Web アプリへ渡しません。

必要条件

• VS Code 1.85 以降。

フィードバック

表示に問題がある場合は、issue にファイル形式、VS Code のバージョン、拡張機能のバージョン、再現可能な例を記載してください。機密情報を含むファイルは添付しないでください。

License

Licensed under the POSH SOFTWARES license. See the LICENSE file included with this extension.