Skip to content
| Marketplace
Sign in
Visual Studio Code>Other>ClavisNew to Visual Studio Code? Get it now.
Clavis

Clavis

anet systems

|
1 install
| (0) | Free
Browse workspace files, preview Markdown and images, and inspect CSS, HTML, JavaScript, PHP and Python structure.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

Clavis

English | 日本語


English

A VSCode extension for browsing your workspace files and previewing Markdown, CSS, HTML, JavaScript, PHP, Python, and images.

Key Features

File list & workspace switching

  • Clavis loads your current workspace and shows a preview of whichever file is open.
  • When you have multiple workspace folders (multi-root), switch between them anytime from the tabs always shown at the top.
  • The header buttons let you reload the workspace and toggle the display language (Japanese/English).

alt text

  • Files and folders in the workspace are shown as a drill-down menu.
  • Selecting a file from the menu shows its preview.

Archive

  • A dedicated file space you can reach from any workspace.
  • From the "⋮" menu on a tab in the sidebar's "Open Files" list, choose "Add to Archive" to save a copy of that file into the archive (the original file is left untouched).
  • The header's box icon (Archive button) switches the file list to the archive's contents, the same way switching workspaces does. Selecting a workspace tab returns you to it anytime.
  • The destination folder can be set via the clavis.archivePath setting. When unset, Clavis uses its own extension storage folder, which you can reach directly (without going through Clavis) from your OS's file manager at:
    • macOS: ~/Library/Application Support/Code/User/globalStorage/anetsystems.clavis-opener/archive/
    • Windows: %APPDATA%\Code\User\globalStorage\anetsystems.clavis-opener\archive\
    • Linux: ~/.config/Code/User/globalStorage/anetsystems.clavis-opener/archive/
  • If a file with the same name already exists, it's automatically numbered (e.g. "filename (2).ext") instead of being overwritten.
  • Folders can't be added to the archive (files only).

Sidebar

alt text

The sidebar on the left has two tabs, "Files" and "Outline". The sidebar itself can be collapsed, and its width can be dragged to resize.

  • Files: lists open files grouped by workspace (each group can be expanded/collapsed). Stays in sync with VSCode's own tabs; click a file to switch its preview, and use the "⋮" menu to "Close" or "Add to Archive".
  • Outline:
    • For Markdown files, shows a heading list. Click to jump to a heading; in edit mode you can also change a heading's level (←→) or reorder it (↑↓), with changes applied to the file immediately and an undo button available.
    • For CSS, HTML, JavaScript, PHP and Python files, shows a structure list (selectors, tags, functions, classes, etc.). Each item can be collapsed, and clicking one jumps to and briefly highlights the matching line in the preview.
    • For image files, shows the file name, size (width × height), byte size and format.

Preview

Markdown
  • Click a Markdown file to show its preview.
  • Auto-generates a table of contents with [toc].
  • Lets you drill down through heading levels step by step with Nest Zoom (see "Nest Zoom" below; the heading list itself lives in the sidebar's "Outline" tab).
  • Checklists (- [ ] todo) can be checked by clicking, and the state is saved straight back to the file (including checklists inside table cells).
  • Clicking a URL link in the body lets you choose, each time, whether to open it in VSCode's built-in browser or an external one.
  • Edits to the underlying file are reflected in the preview in real time.
Code
  • Opening a code file shows the raw source as-is, with line numbers and syntax highlighting.
  • You can jump to any location from the Outline.
  • Nest Zoom works in the preview here too, letting you switch between tabs split by structural level (see "Nest Zoom" below).
  • Supported extensions: CSS (.css), HTML (.html/.htm), JavaScript (.js/.mjs/.cjs), PHP (.php/.phtml, including any mixed-in HTML structure), Python (.py/.pyw, parsed by indentation-based blocks; no local Python install or code execution required).

Image previews

Previews PNG, APNG, JPEG, GIF, WebP, SVG, BMP, ICO, AVIF, TIFF, HEIC and more. While an image is open, the sidebar's "Outline" tab shows its file name, size (width × height), byte size and format, and keeps them in sync as the image changes.

Nest Zoom

nestzoom

alt text

A feature for reading long documents or code at just the level of detail you want. Works in both the Markdown preview and the CSS/HTML/JavaScript/PHP/Python code previews.

  • Controlled from the zoom controls above the preview (zoom in/out buttons, plus a "N-" indicator showing the current level).
  • Zooming in turns the sibling elements at that level (e.g. headings at the same level, or functions/tags at the same level) into side-by-side tabs, expanding only the selected tab's contents further. Siblings you didn't pick aren't discarded — they're just tucked behind the tab bar and can be reached anytime by switching tabs.
  • Zooming in further reveals the selected tab's own children (sub-headings, nested functions, etc.) as another tab layer, letting you drill down as deep as you like (CSS only has one such layer, grouping selectors).
  • Zooming out returns to the level above; reaching N0 returns to the initial view (everything shown at once, without tabs — raw source for everything except CSS).
  • The underlying file never changes no matter what level you're zoomed to — this is purely a display-level fold/split and has no effect on the saved file or code execution.
  • When several files are open as tabs, each file's zoom level and selected tab are kept independently, so you can look at another file and pick up right where you left off.
  • Splitting units per language:
    • Markdown: heading levels (# through ######)
    • CSS: groups of selectors/rules
    • HTML: the hierarchy of tags carrying attributes like id/class
    • JavaScript: functions, classes, methods, variables, import/export, event registrations
    • PHP: functions, classes, methods, properties, constants, namespace/use, control flow, loops, echo, etc. (including any mixed-in HTML)
    • Python: functions, classes, control flow and other indentation-based blocks

Supported Markdown syntax

Feature Syntax Notes
Heading # Heading 1 through ###### Heading 6 Also listed in the sidebar's "Outline" tab
TOC [toc] The line is replaced with a linked heading list
Bold **bold** or __bold__
Italic *italic*
Strikethrough ~~strikethrough~~
Inline code `code`
Code block ```lang
code
```
Language name is optional
Link [text] (URL) Workspace-relative paths navigate inside Clavis; http(s):// links let you pick VSCode's built-in or an external browser on click
Image ![alt] (path) Shows local images (workspace-relative paths), remote images (https://), or data URIs
Blockquote > quote
Horizontal rule --- (3+ of -/*/_)
Table see the code block below Supports left/center/right alignment
List - item / 1. item Supports nesting via indentation
Checklist - [ ] todo / - [x] done Click to check; state is saved straight back to the file (also works inside table cells)

How to write a table (shown outside a table here, since a literal | inside a table cell would otherwise confuse Clavis's own table parser):

| A | B |
| --- | --- |
| 1   | 2   |

Not supported: raw embedded HTML — it's shown as plain text rather than being rendered as actual tags.

Usage

  1. Run Clavis: Open from the Command Palette to open Clavis
  2. Click a file in the file list to switch to its preview (Markdown, CSS, HTML, JavaScript, PHP, Python and images are all supported)
  3. Click "Edit in VSCode" to open the file in VSCode's own editor, split beside Clavis. Click the Clavis icon button in the editor's title bar to show that file in Clavis again
  4. If you open a supported file directly in VSCode without going through Clavis, that same Clavis icon button appears too. Clicking it opens Clavis (starting it first if it isn't already running) and shows that file's preview

Requirements

  • VSCode 1.74.0 or later

License

All Rights Reserved. See the LICENSE file included with this extension for details.

Parser development & rebuilding

npm ci
npm run build:parsers
npm test

The HTML/JS parsers are bundled in webview/vendor/source-parsers.js and require no network access at runtime. When regenerating them, also update the generated files and webview/vendor/LICENSES.md; see that file for license information.


日本語

ワークスペースのファイルを閲覧し、Markdown・CSS・HTML・JavaScript・PHP・Python・画像をプレビューできるVSCode拡張機能です。

主な機能

ファイル一覧・ワークスペース切替

  • Clavisは今開いているワークスペースを読み込んで、開いているファイルのプレビューを表示します。
  • 複数のワークスペースフォルダ(マルチルート)がある場合、常に表示されている上部のタブからいつでも切り替え可能です。
  • ヘッダーのボタンでワークスペースの再読み込み、表示言語(日本語/英語)の切替が可能です。

alt text

  • ワークスペース内のファイル・フォルダがメニュー形式で表示されます。
  • メニューから選択したファイルがプレビューで表示されます。

アーカイブ

  • ワークスペースをまたいで常に参照できる専用のファイル置き場です。
  • サイドバーの「開いているファイル」に並ぶタブの「⋮」メニューから「アーカイブに追加」を選ぶと、そのファイルのコピーをアーカイブへ保存することができます。(元ファイルはそのまま残ります)
  • ヘッダーの箱アイコン(アーカイブボタン)で、ワークスペース切り替えと同様にファイル一覧の表示をアーカイブの中身に切り替え可能です。ワークスペースのタブを選べばいつでも元に戻れます。
  • 保存先フォルダは設定 clavis.archivePath で指定可能。未設定時は拡張機能専用のストレージフォルダを使用し、Clavisを介さずOS標準のファイル管理アプリ等から直接アクセス・編集したい場合は以下の場所にあります。
    • macOS: ~/Library/Application Support/Code/User/globalStorage/anetsystems.clavis-opener/archive/
    • Windows: %APPDATA%\Code\User\globalStorage\anetsystems.clavis-opener\archive\
    • Linux: ~/.config/Code/User/globalStorage/anetsystems.clavis-opener/archive/
  • 同名ファイルが既にある場合は「ファイル名 (2).拡張子」のように自動で連番を付与し、上書きしないようになっています。
  • フォルダはアーカイブに追加不可(ファイル単位のみになります)

サイドバー

alt text

画面左のサイドバーには「ファイル」「アウトライン」の2つのタブがある。サイドバー自体は折りたたみ可能、幅もドラッグで調整できる。

  • ファイル:開いているファイルをワークスペースごとにグループ分けして一覧表示(グループごとに開閉可能)。VSCode本体のタブと連動し、クリックでそのファイルのプレビューに切り替え、「⋮」メニューから「閉じる」「アーカイブに追加」を実行できる
  • アウトライン:
    • Markdownファイルでは見出し一覧を表示。クリックでその見出しへジャンプでき、編集モードでは見出しの階層変更(←→)・並べ替え(↑↓)が可能(操作は即座にファイルへ反映、元に戻すボタンあり)
    • CSS・HTML・JavaScript・PHP・Pythonファイルでは構造一覧(セレクター・タグ・関数・クラスなど)を表示。項目ごとに折りたたみ可能で、クリックするとプレビュー内の該当行へジャンプし、一瞬ハイライトして知らせる
    • 画像ファイルではファイル名・サイズ(幅 × 高さ)・容量・形式を表示

プレビュー

Markdown
  • Markdownファイルをクリックするとプレビューが表示されます。
  • [toc] で目次を自動生成
  • 見出しの階層をnest zoomで段階的に掘り下げて閲覧可能(詳細は後述の「Nest Zoom」を参照。見出し一覧自体はサイドバーの「アウトライン」タブから)
  • チェックリスト(- [ ] todo)はクリックでチェックでき、状態はそのままファイルへ保存される(テーブルのセル内のチェックリストにも対応)
  • 本文中のURLリンクをクリックすると、VSCode内蔵ブラウザ/外部ブラウザのどちらで開くかをその都度選べます。
  • 元ファイルの編集はプレビューへリアルタイムに反映されます。
コード
  • コードファイルを開くと行番号付き・シンタックスハイライト済みの生のソースコードがそのまま表示されます。
  • アウトラインから該当箇所へジャンプすることができます。
  • プレビュー側でもnest zoomを使うと、同じ構造を階層ごとに区切ったタブとして切り替えながら読める(詳細は次項「Nest Zoom」を参照)
  • 対応拡張子:CSS(.css)、HTML(.html/.htm)、JavaScript(.js/.mjs/.cjs)、PHP(.php/.phtml、混在するHTMLの階層も含む)、Python(.py/.pyw、インデントに基づくブロックを解析。Python本体のインストールやコード実行は不要)

画像プレビュー

PNG・APNG・JPEG・GIF・WebP・SVG・BMP・ICO・AVIF・TIFF・HEICなどの画像をプレビュー。画像を開いている間は、サイドバーの「アウトライン」タブにファイル名・画像サイズ(幅 × 高さ)・容量・形式を表示し、画像の更新にも追従します。

Nest Zoom

nestzoom

alt text

長い文書やコードを、見たい粒度だけに絞って読むための機能です。Markdownプレビューと、CSS・HTML・JavaScript・PHP・Pythonのコードプレビューの両方で使用が可能です。

  • プレビュー上部のズームコントロール(ズームイン/ズームアウトボタンと、現在の階層を示す「N-」)で操作
  • ズームインすると、その階層の兄弟要素(例:同じレベルの見出し、同じ階層の関数やタグ)がタブとして横並びになり、選んだタブの中身だけがさらに展開される。選ばなかった兄弟は消えるのではなくタブの裏に隠れるだけで、タブ切り替えでいつでも見られます。
  • さらにズームインすると、選んだタブの中の子要素(見出しの小見出し、関数の中の関数など)がもう一段タブとして現れ、好きな深さまで掘り下げられる(CSSはセレクターのグループをタブ化する1階層のみ)
  • ズームアウトすると一段上の粒度に戻り、N0まで戻ると最初の表示(タブを使わず全体を通して表示する状態。CSS以外は生のソース表示)に戻ります。
  • どの階層にズームしていても元のファイルの内容が変わるわけではありません。あくまで表示上の折りたたみ・分割であり、保存されるファイルやコードの実行には影響しません。
  • 複数ファイルをタブで開いている場合、各ファイルのズーム階層・選択中のタブはファイルごとに保持されます。別のファイルを見てから戻っても続きから再開できます。
  • 言語ごとの分割単位:
    • Markdown:見出し(#〜######)の階層
    • CSS:セレクター・ルールのグループ
    • HTML:id・classなどの属性付きタグの階層
    • JavaScript:関数・クラス・メソッド・変数・import/export・イベント登録
    • PHP:関数・クラス・メソッド・プロパティ・定数・namespace/use・条件分岐・ループ・echoなど(混在するHTMLも含む)
    • Python:関数・クラス・条件分岐・ループなどインデントに基づくブロック

対応しているMarkdown記法

機能 書き方 備考
見出し # 見出し1 〜 ###### 見出し6 サイドバーの「アウトライン」タブでも一覧表示
目次 [toc] その行が見出し一覧(リンク付き)に置き換わる
太字 **太字** または __太字__
斜体 *斜体*
取り消し線 ~~取り消し線~~
インラインコード `code`
コードブロック ```lang
コード
```
言語名は省略可
リンク [テキスト] (URL) ワークスペース内の相対パスはClavis内で遷移、http(s)://はクリック時にVSCode内蔵/外部ブラウザを選択
画像 ![alt] (画像パス) ローカル画像(ワークスペース内の相対パス)・リモート画像(https://)・data URIのいずれも表示可能
引用 > 引用文
水平線 --- (-/*/_を3つ以上)
テーブル 下記のコードブロック参照 左寄せ/中央/右寄せの指定に対応
リスト - item / 1. item インデントで入れ子に対応
チェックリスト - [ ] todo / - [x] done クリックでチェックでき、状態はそのままファイルへ保存される(テーブルのセル内でも使用可能)

テーブルの書き方(パイプ|を表のセル内に書くとClavis自身の表パーサーが誤って区切ってしまうため、ここだけ表の外に記載):

| A | B |
| --- | --- |
| 1   | 2   |

非対応: 生のHTML埋め込みには対応しておらず、タグとしてではなくそのままテキストとして表示されます。

使い方

  1. コマンドパレットから Clavis: Open を実行すると、Clavisが開きます
  2. ファイル一覧でファイルをクリックすると、プレビューに切り替わります(Markdown・CSS・HTML・JavaScript・PHP・Python・画像に対応)
  3. 「VSCodeで編集」を押すと、VSCode本来のエディタがClavisの横にスプリットで開きます。エディタのタイトルバーのclavisのアイコンボタンを押すと、そのファイルをClavis側で表示できます
  4. Clavisを使わずに直接VSCodeで対応ファイルを開いていた場合も、同じClavisのアイコンボタンが表示されます。押すとClavisが(まだ開いていなければ起動した上で)そのファイルをプレビュー表示します

動作要件

  • VSCode 1.74.0以上

ライセンス

All Rights Reserved. 詳細はこの拡張機能に同梱のLICENSEファイルを参照してください。

パーサーの開発・再生成

npm ci
npm run build:parsers
npm test

HTML・JSのパーサーは webview/vendor/source-parsers.js に同梱し、実行時に外部通信を必要としません。再生成時は生成物と webview/vendor/LICENSES.md も更新します。ライセンス情報は同ファイルを参照してください。

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft