Silk Math Preview

English · 中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Português · Русский · Italiano

Live math preview that follows your caret.

LaTeX · TeX · Markdown · MDX · Jupyter · MathJax · Windows / macOS / Linux

Visual Studio Marketplace · GitHub

English

A Visual Studio Code extension that previews LaTeX formulas as you type. Open a .tex, Markdown, MDX, or Quarto file, or a Jupyter notebook (.ipynb), and place the caret inside a formula. A floating MathJax preview appears beside it, with a thin orange line marking your typing position. There is no need to run latexmk, generate a PDF, or compile the document.

Supports inline math with $...$ and \(...\), display math with \[...\], environments such as equation, align, and tabular, and GitHub Flavored Markdown tables. Undefined commands appear in red while the rest of the formula continues to render.

Package declarations and local dependencies are detected automatically, including common custom macros from .sty / .cls files and unsaved changes in open dependency files. Number and unit commands such as \num, \SI, and \qty, along with custom macros usable in text mode, also work in table cells. Macro support and limits (Chinese).

Install by searching for Silk Math Preview in the Extensions view, or visit the Visual Studio Marketplace page. Requires VS Code 1.95 or later on Windows, macOS, or Linux.

• Math completion: Formula-only argument snippets, paired environments, custom macros, and local label/reference/citation keys, including unsaved edits. silkMath.completion.mode supports per-language on (default), off, or strict manual, independently of preview. Choose Math completion mode… in the status menu to set the current language. In manual, use Ctrl+Space with the list closed or Silk Math: Trigger Math Completion; Math completion shortcut… changes the keys (silkMath.triggerCompletion). These Silk shortcut entries are enabled only in manual; on keeps automatic suggestions and native VS Code key behavior. Test build: silkMathTest.*, Ctrl+Alt+Shift+Space. Optional variants default on (completion.optionalArguments); use completion.packages for package candidates and completion.snippets to override or hide commands. Prose, image paths, comments, and Markdown code are excluded. Dynamic references and some TeX commands remain limited; other providers may still duplicate items. Guide and limits (Chinese / English).
• Toggle preview: Ctrl+Alt+M (Mac: ⌘⌥M). Press Esc to dismiss the current preview.
• Settings: Click Silk Math in the status bar to adjust the preview size and enabled file types. Other file types is off by default; enable it to recognize LaTeX in plain text, including untitled files. Silk Math → Edit file exclusion rules… opens silkMath.preview.excludeFiles and silkMath.completion.excludeFiles. Both default to []; add *.tex for all TeX files, notes.tex for that filename anywhere, a workspace-relative path such as chapters/draft.tex, or an absolute path for one file. Patterns are case-insensitive and support *, ?, and whole-segment **. Existing silkMath.preview.excludeFileTypes and silkMath.completion.excludeFileTypes still accept extensions (.tex, .md, *.ipynb) or language IDs (latex, markdown). The status menu can exclude or restore preview, completion, or both for the current file (the entire notebook for notebook cells). File choices stay local to this workspace; restoring a file still follows exclusion rules, preview switches, and completion mode. If a rule still excludes the file, the menu shows that rule. The rule editor always offers Add actions; select a rule to edit it, or clear it to delete it. New rules go to User settings unless you choose another scope (Workspace, Folder, or a language override). Silk Math → All keyboard shortcuts… lists all actions, including screenshot capture; choose one to add or change its keys in VS Code. Existing bindings stay intact; Silk’s completion trigger remains limited to manual.
• Copy image: A separate 26px area on the right keeps the button clear of the formula, including while scrolling. The upper-right button copies the complete formula as a PNG with black ink on a solid white background, without an editing caret or cropped scroll content. Everything happens in the background; no extra page opens. Only a successful clipboard write triggers a smooth checkmark, which returns to the copy icon after 1.6 seconds; reduced-motion preferences are respected. Windows/macOS use system clipboard interfaces; Linux requires wl-copy (Wayland) or xclip (X11).
• Preview CSS: Choose Silk Math → Edit preview CSS…; save to apply, or clear and save to reset. Oversized formulas retain their font size in a floating viewport with horizontal and vertical scrolling and 5px scrollbar thumbs. Opening or editing shows the rendered caret’s surroundings; manual scrolling remains free until the next edit or caret move. All preview sizes strictly keep the selected above/below/right side (default: below), even when space is limited. Display math is 15% smaller; inline math is unchanged. For all formula sizes, choose caret/selection/formula anchors and above/below/right placement, with gaps, offsets, and overlap controls. Customize font size, viewport limits, background, border, and shadow. Defaults: 4px 8px padding and 6px corners. Completion, hover help, and all options have Chinese/English explanations. Precise bounds depend on compatible editor layout. Scrolling, CSS examples, and limits (Chinese / English).
• TikZ / pgfplots: Enable TikZ / pgfplots live preview (silkMath.tikz.enabled, off by default), then place the caret in a tikzpicture. Unsaved edits update the SVG. First use downloads a verified WebAssembly renderer; subsequent use works offline without a LaTeX installation. Includes pgfplots 1.18.3, compat=1.18, grouped plots, plot libraries, and native macro definitions. Complex pictures may take longer; this is not a full TeX distribution. TikZ guide and examples (Chinese / English).
• Screenshot and image recognition (OCR): Click the capture icon in the status bar, then drag to select a screen region. Recognition starts when you release the mouse; copy, insert, or edit the result in a compact menu. Choose Silk Math → Recognize image… to paste an image or select a PNG / JPEG file. Models download on first use and run locally; images are not uploaded.
• OCR shortcuts: Ctrl+Alt+O (Mac: ⌘⌥O) opens the recognition menu, where Ctrl+V (Mac: ⌘V) pastes an image. In the editor, Ctrl+Alt+V (Mac: ⌘⌥V) recognizes the clipboard image directly. Standard image pasting in LaTeX and Markdown editors also triggers OCR when silkMath.ocr.pasteImages is enabled (the default). If your editor lacks the image-paste API, use the recognition menu or the direct clipboard shortcut.
• OCR accuracy: Outer whitespace is trimmed and backgrounds are normalized; questionable results get one retry. Table structure is retained, but results may be flagged for review. Complex tables, handwriting, and blurry images still need checking. Recognition behavior and limits (Chinese).
• Test build: Add Shift to the Ctrl+Alt+M/O/V shortcuts (Mac: ⌘⌥M/O/V). The test build uses separate silkMathTest.* settings; automatic image recognition on paste is off by default and can be enabled with silkMathTest.ocr.pasteImages. If both builds preview the same editor, the test build takes priority in the shared floating window.

Formulas inside theorem or proposition environments are previewed individually; theorem text and numbering are not typeset. Long-document scanning retains delimiter context, and literal LaTeX code does not affect surrounding formula boundaries.

Languages

中文

在 Visual Studio Code 中边写边看 LaTeX 公式。打开 .tex、Markdown、MDX、Quarto 文件或 Jupyter 笔记本（.ipynb），把光标放进公式，旁边就会出现 MathJax 浮动预览，橙色细线标出当前输入位置。无需运行 latexmk、生成 PDF 或编译整份文档。

支持行内公式 $...$、\(...\)，独立公式 \[...\]，equation、align、tabular 等环境，以及 GitHub 风格的 Markdown 表格。未定义的命令以红色显示，其余部分继续渲染。

自动分析宏包声明和本地依赖，识别 .sty / .cls 中的常见自定义宏，也会读取已打开依赖文件中尚未保存的修改。\num、\SI、\qty 等数字和单位命令，以及可用于文本模式的自定义宏，同样支持在表格单元格内展开。详见宏支持范围与限制。

在扩展视图中搜索 Silk Math Preview 即可安装，或打开 Visual Studio Marketplace 页面。支持 Windows、macOS 和 Linux，需要 VS Code 1.95 或更高版本。

• 数学补全： 公式内提供参数 snippet、配对环境、自定义宏和本地标签、引用、文献键，包含未保存修改。silkMath.completion.mode 可按语言设为 on（默认）、off 或严格 manual，不影响预览。在状态栏菜单选择“数学补全模式…”即可调整当前语言。manual 下在列表关闭时按 Ctrl+Space，或运行 Silk Math: 触发数学补全 / Trigger Math Completion；“数学补全快捷键…”可改键（silkMath.triggerCompletion）。Silk 专用按键和改键入口仅在 manual 启用；on 自动提供候选，保留 VS Code 原有按键行为。测试版：silkMathTest.*、Ctrl+Alt+Shift+Space。可选参数变体默认开启（completion.optionalArguments）；completion.packages 补充宏包候选，completion.snippets 覆盖或隐藏命令。普通正文、插图路径、注释和 Markdown 代码不参与。动态引用及部分 TeX 命令仍有限制，其他 provider 的候选仍可能重复。详见使用说明与限制（中英双语）。
• 开关预览： Ctrl+Alt+M（Mac：⌘⌥M）。按 Esc 关闭当前预览。
• 设置： 点击状态栏的 Silk Math，调整预览大小和启用的文件类型。其他文件类型默认关闭；开启后，纯文本和未命名文件也能按 LaTeX 语法识别公式。 点击 Silk Math → 编辑文件排除规则…，分别编辑 silkMath.preview.excludeFiles 和 silkMath.completion.excludeFiles，默认均为 []。*.tex 排除所有 TeX 文件；notes.tex 排除任意目录的同名文件；chapters/draft.tex 相对于工作区文件夹；绝对路径仅排除对应文件。规则不区分大小写，支持 *、? 和整段 **。原有 silkMath.preview.excludeFileTypes 与 silkMath.completion.excludeFileTypes 仍支持后缀（.tex、.md、*.ipynb）和语言 ID（latex、markdown）。 状态栏菜单可分别排除或恢复当前文件的预览、补全，或两者一起操作；Notebook 按整个笔记本处理。单文件选择仅保存在本地工作区，恢复后仍遵循排除规则、预览开关和补全模式；菜单会显示仍在排除该文件的规则。 规则编辑菜单始终显示添加入口；点击已有规则可修改，清空后确认即可删除。新规则默认保存到用户设置，也可切换工作区、文件夹或语言范围。Silk Math → 修改各项快捷键… 列出截图等全部操作，选择后即可在 VS Code 中修改或添加按键；保留已有绑定，Silk 补全触发仍仅限 manual。
• 复制图片： 右侧为按钮预留独立的 26px 空间，滚动时也不遮挡公式。右上角按钮在后台复制完整公式的白底黑字 PNG，去掉编辑光标，不裁切滚动范围外的内容，不打开额外页面。剪贴板真正写入成功后，图标平滑变为勾，约 1.6 秒后恢复；遵循系统减少动态效果设置。Windows/macOS 使用系统剪贴板接口；Linux 需要 wl-copy（Wayland）或 xclip（X11）。
• 预览 CSS： 选择 Silk Math → 编辑预览 CSS…，保存即生效，清空并保存恢复默认。长宽公式保持实际字号，在浮层内上下、左右滚动，滑块宽 5px。打开或继续编辑时先显示公式光标周围内容；手动滚动后保持位置，直到下一次编辑或移动源码光标。所有尺寸的预览严格保持所选上方、下方或右侧（默认下方），空间不足也不自动换边。行间公式缩小 15%，行内字号不变。所有尺寸的公式可相对光标、选区或整块公式放在上方、下方、右侧，设置间隔、偏移和覆盖策略；可调整字号、滚动窗口上限、背景、边框和阴影。默认内边距 4px 8px、圆角 6px，支持参数补全、悬停和全部参数的中英说明。精确边界依赖兼容的编辑器布局。详见滚动、CSS 示例与限制（中英双语）。
• TikZ / pgfplots： 勾选 TikZ / pgfplots 实时预览（silkMath.tikz.enabled，默认关闭），把光标放进 tikzpicture，无需保存即可随编辑更新 SVG。首次使用下载并校验 WebAssembly 渲染组件，之后可离线运行，无需安装 LaTeX。附带 pgfplots 1.18.3，支持 compat=1.18、分组图、绘图库和原生宏定义。复杂图形可能需要更长时间，支持范围不等同于完整 TeX 发行版。详见使用说明和示例（中英双语）。
• 截图与图片识别（OCR）： 点击状态栏截图图标，拖动框选屏幕区域，松开鼠标后自动识别；在小菜单中复制、插入或编辑结果。Silk Math → 识别图片… 可粘贴图片或选择 PNG / JPEG 文件。模型首次使用时下载，识别在本机完成，图片不会上传。
• OCR 快捷键： Ctrl+Alt+O（Mac：⌘⌥O）打开识别菜单，在菜单内按 Ctrl+V（Mac：⌘V）粘贴图片。在编辑器中按 Ctrl+Alt+V（Mac：⌘⌥V）可直接识别剪贴板图片。silkMath.ocr.pasteImages 默认开启，支持在 LaTeX、Markdown 编辑器中直接粘贴图片识别。编辑器不支持图片粘贴 API 时，可使用识别菜单或直接读取剪贴板的快捷键。
• OCR 精度： 自动裁去外侧留白、统一背景，对可疑结果额外识别一次。表格结构会保留，但可能提示复核；复杂表格、手写和模糊图片仍需检查。详见识别流程与限制。
• 测试版： Ctrl+Alt+M/O/V（Mac：⌘⌥M/O/V）这三组快捷键需要额外按 Shift。测试版使用独立的 silkMathTest.* 设置，自动粘贴图片识别默认关闭，可通过 silkMathTest.ocr.pasteImages 开启。 两个版本同时预览同一编辑器时，测试版优先使用共用浮层。

定理或 proposition 环境内部的公式会单独预览，不排版定理正文和编号。长文档扫描保留数学定界符上下文，LaTeX 原样代码不会干扰外围公式的边界。

语言

繁體中文

在 Visual Studio Code 中一邊輸入，一邊預覽 LaTeX 公式。開啟 .tex、Markdown、MDX、Quarto 檔案或 Jupyter 筆記本（.ipynb），將游標放入公式，旁邊就會出現 MathJax 浮動預覽，橘色細線標示目前的輸入位置。無須執行 latexmk、產生 PDF 或編譯整份文件。

支援行內公式 $...$、\(...\)，獨立公式 \[...\]，equation、align、tabular 等環境，以及 GitHub 風格的 Markdown 表格。未定義的命令會以紅色顯示，其餘部分仍可正常呈現。

自動分析套件宣告與本機相依檔案，辨識 .sty / .cls 中常見的自訂巨集，也會讀取已開啟相依檔案中尚未儲存的修改。\num、\SI、\qty 等數字與單位命令，以及可用於文字模式的自訂巨集，也能在表格儲存格中展開。詳見巨集支援範圍與限制（簡體中文）。

在擴充功能檢視中搜尋 Silk Math Preview 即可安裝，或開啟 Visual Studio Marketplace 頁面。支援 Windows、macOS 和 Linux，需要 VS Code 1.95 或更新版本。

• 數學自動完成： 公式內提供含參數的程式碼片段、成對環境、自訂巨集及本機標籤、參照與文獻鍵，包含未儲存的修改。silkMath.completion.mode 可依語言設為 on（預設）、off 或嚴格的 manual，不影響預覽。在狀態列選單選擇「數學自動完成模式…」即可調整目前語言。manual 下，在清單關閉時按 Ctrl+Space，或執行 Silk Math: Trigger Math Completion（觸發數學自動完成）；「數學自動完成快速鍵…」可自訂按鍵（silkMath.triggerCompletion）。Silk 專用快速鍵和設定入口僅在 manual 啟用；on 自動提供候選並保留 VS Code 原有按鍵行為。測試版：silkMathTest.*、Ctrl+Alt+Shift+Space。選用參數變體預設開啟（completion.optionalArguments）；completion.packages 補充套件候選，completion.snippets 覆寫或隱藏命令。一般內文、圖片路徑、註解與 Markdown 程式碼不參與。動態參照和部分 TeX 命令仍有限制，其他擴充功能的候選仍可能重複。詳見說明與限制（簡體中文／英文）。
• 開關預覽： Ctrl+Alt+M（Mac：⌘⌥M）。按 Esc 關閉目前的預覽。
• 設定： 點選狀態列的 Silk Math，調整預覽大小與啟用的檔案類型。其他檔案類型預設關閉；啟用後，純文字與未命名檔案也能依 LaTeX 語法辨識公式。 點選 Silk Math → 編輯檔案排除規則…，分別編輯 silkMath.preview.excludeFiles 和 silkMath.completion.excludeFiles，預設皆為 []。*.tex 排除所有 TeX 檔案；notes.tex 排除任何目錄的同名檔案；chapters/draft.tex 相對於工作區資料夾；絕對路徑僅排除對應檔案。規則不分大小寫，支援 *、? 和整段 **。原有 silkMath.preview.excludeFileTypes 與 silkMath.completion.excludeFileTypes 仍支援副檔名（.tex、.md、*.ipynb）及語言 ID（latex、markdown）。 狀態列選單可分別排除或恢復目前檔案的預覽、自動完成，或同時操作兩者；Notebook 以整份筆記本為單位。單一檔案的選擇僅儲存於本機工作區，恢復後仍遵循排除規則、預覽開關和自動完成模式；選單會顯示仍排除此檔案的規則。 規則編輯選單始終顯示新增入口；點選既有規則可修改，清空後確認即可刪除。新規則預設儲存於使用者設定，也可切換工作區、資料夾或語言範圍。Silk Math → 修改各項快速鍵… 列出螢幕擷取等所有操作，選擇後即可在 VS Code 中修改或新增快速鍵；保留既有繫結，Silk 自動完成的手動觸發仍僅限 manual。
• 複製圖片： 右側為按鈕保留獨立的 26px 空間，捲動時也不遮住公式。右上角按鈕在背景複製完整公式的白底黑字 PNG，去掉編輯游標，不裁切捲動範圍外的內容，不開啟額外頁面。剪貼簿確實寫入成功後，圖示平滑變為勾號，約 1.6 秒後還原；遵循系統減少動態效果設定。Windows/macOS 使用系統剪貼簿介面；Linux 需要 wl-copy（Wayland）或 xclip（X11）。
• 預覽 CSS： 選擇 Silk Math → 編輯預覽 CSS…，儲存即套用，清空後儲存可還原預設值。過寬或過高的公式保留實際字級，可在浮層內上下、左右捲動，捲軸滑塊寬 5px。開啟或繼續編輯時先顯示公式游標附近內容；手動捲動後保留位置，直到下次編輯或移動原始碼游標。所有尺寸的預覽嚴格保持所選上方、下方或右側（預設下方），空間不足也不自動換邊。區塊公式縮小 15%，行內字級不變。所有尺寸的公式可依游標、選取範圍或整個公式置於上、下、右方，設定間距、位移及重疊策略；亦可調整字級、捲動視窗上限、背景、框線與陰影。預設內距 4px 8px、圓角 6px，提供參數補全、懸停及所有參數的中英說明。精確邊界取決於相容的編輯器版面。捲動、CSS 範例與限制（中英雙語）。
• TikZ / pgfplots： 勾選 TikZ / pgfplots 即時預覽（silkMath.tikz.enabled，預設關閉），將游標放入 tikzpicture，尚未儲存的修改也會即時更新 SVG。首次使用會下載並驗證 WebAssembly 繪圖元件，之後可離線執行，無須安裝 LaTeX。內含 pgfplots 1.18.3，支援 compat=1.18、群組圖表、繪圖函式庫與原生巨集定義。複雜圖形可能需要較長時間，支援範圍不等同於完整的 TeX 發行版。詳見使用說明與範例（簡體中文／英文）。
• 螢幕截圖與圖片辨識（OCR）： 點選狀態列的截圖圖示，拖曳框選螢幕區域，放開滑鼠後即開始辨識；在精簡選單中複製、插入或編輯結果。Silk Math → 辨識圖片… 可貼上圖片或選擇 PNG / JPEG 檔案。模型於首次使用時下載，辨識作業在本機完成，不會上傳圖片。
• OCR 快速鍵： Ctrl+Alt+O（Mac：⌘⌥O）開啟辨識選單，在選單內按 Ctrl+V（Mac：⌘V）貼上圖片。在編輯器中按 Ctrl+Alt+V（Mac：⌘⌥V）可直接辨識剪貼簿圖片。silkMath.ocr.pasteImages 預設開啟，支援在 LaTeX、Markdown 編輯器中直接貼上圖片辨識。若編輯器不支援圖片貼上 API，可使用辨識選單或直接讀取剪貼簿的快速鍵。
• OCR 準確度： 自動裁去外圍留白、統一背景，並針對可疑結果額外辨識一次。表格結構會保留，但可能提示檢查；複雜表格、手寫與模糊圖片仍須核對。詳見辨識流程與限制（簡體中文）。
• 測試版： Ctrl+Alt+M/O/V（Mac：⌘⌥M/O/V）這三組快速鍵需額外按 Shift。測試版採用獨立的 silkMathTest.* 設定，貼上圖片自動辨識功能預設關閉，可透過 silkMathTest.ocr.pasteImages 啟用。 兩個版本同時預覽同一編輯器時，測試版優先使用共用浮層。

定理或 proposition 環境內部的公式會單獨預覽，不排版定理正文和編號。長文件掃描保留數學定界符上下文，LaTeX 原樣程式碼不會干擾外圍公式的邊界。

語言

日本語

Visual Studio Code で、入力しながら LaTeX の数式を確認できる拡張機能です。.tex、Markdown、MDX、Quarto のファイル、または Jupyter ノートブック（.ipynb）を開き、数式の中にカーソルを置くと、すぐそばに MathJax のプレビューが表示されます。オレンジ色の細い線が入力位置を示します。latexmk の実行や PDF の生成、文書全体のコンパイルは不要です。

インライン数式の $...$ と \(...\)、別行立て数式の \[...\]、equation、align、tabular などの環境、GitHub Flavored Markdown の表に対応しています。未定義のコマンドは赤字で表示され、数式のほかの部分は引き続き描画されます。

パッケージ宣言とローカルの依存ファイルを自動で読み取り、.sty / .cls に記述された一般的な独自マクロや、開いている依存ファイルの未保存の変更も反映します。\num、\SI、\qty などの数値・単位コマンドや、テキストモードで使える独自マクロは、表のセル内でも利用できます。マクロの対応範囲と制限（中国語）。

拡張機能ビューで Silk Math Preview を検索するか、Visual Studio Marketplace のページからインストールしてください。Windows、macOS、Linux に対応し、VS Code 1.95 以降が必要です。

• 数式補完： 数式内で引数付きスニペット、対になる環境、独自マクロ、ローカルのラベル・参照・文献キーを補完し、未保存の変更も反映します。silkMath.completion.mode は言語別に on（既定）、off、厳密な manual を設定でき、プレビューには影響しません。ステータスメニューの「数式補完モード…」で現在の言語を設定できます。manual では一覧を閉じて Ctrl+Space、または Silk Math: Trigger Math Completion を実行します。「数式補完のショートカット…」でキーを変更できます（silkMath.triggerCompletion）。Silk 専用キーと設定項目は manual のみで有効です。on は自動補完と VS Code 標準のキー動作を維持します。テスト版は silkMathTest.* と Ctrl+Alt+Shift+Space を使います。省略可能な引数の候補は既定で有効（completion.optionalArguments）。completion.packages でパッケージ候補を追加し、completion.snippets でコマンドを上書き・非表示にできます。本文、画像パス、コメント、Markdown コードは対象外です。動的な参照や一部の TeX コマンドには制限があり、他の拡張機能と候補が重複する場合があります。使い方と制限（中国語／英語）。
• プレビューの切り替え： Ctrl+Alt+M（Mac：⌘⌥M）でオン／オフを切り替えます。現在のプレビューを閉じるには Esc を押します。
• 設定： ステータスバーの Silk Math をクリックすると、プレビューの大きさや対象のファイル形式を変更できます。その他のファイルは初期設定ではオフです。有効にすると、名前を付けていないファイルを含むプレーンテキストでも LaTeX 数式を認識します。 Silk Math → ファイルの除外ルールを編集… から silkMath.preview.excludeFiles と silkMath.completion.excludeFiles を個別に編集できます。初期値はどちらも [] です。*.tex はすべての TeX ファイル、notes.tex は場所を問わず同名のファイル、chapters/draft.tex はワークスペースフォルダーからの相対パス、絶対パスはそのファイルだけを除外します。大文字小文字を区別せず、*、?、パス要素全体の ** に対応します。従来の silkMath.preview.excludeFileTypes と silkMath.completion.excludeFileTypes では引き続き拡張子（.tex、.md、*.ipynb）や言語 ID（latex、markdown）を指定できます。 ステータスメニューで現在のファイルのプレビュー、補完、または両方を除外・復元できます。Notebook では全体が対象です。選択はこのワークスペースにローカル保存されます。復元後も除外ルール、プレビュー設定、補完モードに従い、除外が続く場合は該当ルールがメニューに表示されます。 ルール編集メニューには常に追加ボタンがあり、既存ルールを選ぶと編集でき、空にして確定すると削除できます。保存先の初期値はユーザー設定で、ワークスペース・フォルダー・言語別設定に変更できます。Silk Math → すべてのキーボードショートカット… で画面キャプチャなどの操作を選び、VS Code でキーを追加・変更できます。既存の割り当ては保持され、Silk の補完起動は manual のみです。
• 画像のコピー： 右側にボタン専用の 26px の余白を設け、スクロール中も数式に重なりません。右上のボタンで、スクロール範囲外も含む数式全体を白地に黒の PNG としてバックグラウンドでコピーします。編集カーソルは除去し、追加ページは開きません。クリップボードへの書き込み成功後にアイコンが滑らかにチェックマークへ変わり、約 1.6 秒で元に戻ります。視差効果を減らす設定に対応。Windows/macOS は標準 API、Linux は wl-copy（Wayland）または xclip（X11）を使用します。
• プレビュー CSS: Silk Math → プレビュー CSS を編集… で変更し、保存して適用します。空にして保存すると初期設定に戻ります。幅や高さの大きい数式は文字サイズを保ち、浮動プレビュー内を上下・左右にスクロールできます。つまみの幅は 5px です。表示時や編集時は数式カーソルの周辺を表示し、手動スクロールの位置は次の編集またはソースカーソル移動まで保持します。すべてのサイズで選択した上・下・右の配置を厳守します（既定は下）。空間不足でも自動で反転しません。別行立て数式は 15% 小さく、行内数式のサイズは従来どおりです。すべてのサイズの数式でカーソル・選択範囲・数式全体を基準に上・下・右へ配置し、間隔、オフセット、重なりを設定できます。文字サイズ、表示領域の上限、背景、枠線、影も調整できます。既定の余白は 4px 8px、角丸は 6px。補完、ホバー、全項目の中国語・英語の説明を利用できます。正確な境界には対応したエディターレイアウトが必要です。スクロールと CSS の例・制限（中国語・英語）。
• TikZ / pgfplots： TikZ / pgfplots ライブプレビュー（silkMath.tikz.enabled、初期設定はオフ）を有効にし、tikzpicture 内にカーソルを置きます。保存前の編集内容も SVG に反映されます。初回に整合性を検証済みの WebAssembly 描画エンジンをダウンロードし、その後は LaTeX をインストールせずにオフラインで利用できます。pgfplots 1.18.3 を同梱し、compat=1.18、グループ化したグラフ、描画ライブラリ、ネイティブなマクロ定義に対応しています。複雑な図は時間がかかることがあり、完全な TeX ディストリビューションと同じ機能を備えているわけではありません。TikZ の使い方と例（中国語・英語）。
• スクリーンショット・画像認識（OCR）： ステータスバーのキャプチャアイコンをクリックし、画面上の範囲をドラッグで選択します。マウスを離すと認識が始まり、小さなメニューから結果のコピー、挿入、編集ができます。Silk Math → Recognize image…（画像認識）では、画像の貼り付けや PNG / JPEG ファイルの選択もできます。モデルは初回にダウンロードされ、認識処理はローカルで行われます。画像はアップロードされません。
• OCR のショートカット： Ctrl+Alt+O（Mac：⌘⌥O）で認識メニューを開き、メニュー内で Ctrl+V（Mac：⌘V）を押すと画像を貼り付けられます。エディター内では Ctrl+Alt+V（Mac：⌘⌥V）でクリップボードの画像を直接認識します。silkMath.ocr.pasteImages は初期設定で有効になっており、LaTeX・Markdown エディターへの通常の画像貼り付けでも OCR が起動します。エディターが画像貼り付け API に対応していない場合は、認識メニューかクリップボード認識のショートカットを使ってください。
• OCR の精度： 外側の余白を切り取り、背景を整えたうえで認識します。不確かな結果は一度だけ再認識します。表の構造は保持しますが、確認を求める場合があります。複雑な表、手書き文字、不鮮明な画像の結果は引き続き確認が必要です。認識処理と制限（中国語）。
• テスト版： Ctrl+Alt+M/O/V（Mac：⌘⌥M/O/V）の各ショートカットには Shift を追加します。設定は独立した silkMathTest.* を使用します。画像の貼り付けによる自動認識は初期設定ではオフで、silkMathTest.ocr.pasteImages から有効にできます。 同じエディターで両方の版がプレビューを表示する場合、共有する浮動ウィンドウではテスト版が優先されます。

定理や proposition 環境内の数式を個別にプレビューします。定理本文と番号は組版しません。長い文書でも数式区切りの文脈を保持し、LaTeX のリテラルコードが周囲の数式境界に影響しないようにします。

言語

한국어

Visual Studio Code에서 LaTeX 수식을 입력하는 동시에 미리 볼 수 있는 확장 기능입니다. .tex, Markdown, MDX, Quarto 파일이나 Jupyter 노트북(.ipynb)을 열고 수식 안에 커서를 놓으면 옆에 MathJax 미리 보기가 나타납니다. 가느다란 주황색 선으로 현재 입력 위치를 표시합니다. latexmk를 실행하거나 PDF를 만들거나 문서 전체를 컴파일할 필요가 없습니다.

인라인 수식 $...$와 \(...\), 별도 줄에 표시하는 수식 \[...\], equation, align, tabular 등의 환경, GitHub Flavored Markdown 표를 지원합니다. 정의되지 않은 명령은 빨간색으로 표시하고 나머지 수식은 계속 렌더링합니다.

패키지 선언과 로컬 종속 파일을 자동으로 분석합니다. .sty / .cls 파일의 일반적인 사용자 정의 매크로와 열려 있는 종속 파일의 저장하지 않은 변경 사항도 반영합니다. \num, \SI, \qty 같은 숫자·단위 명령과 텍스트 모드에서 사용할 수 있는 사용자 정의 매크로는 표 셀 안에서도 작동합니다. 매크로 지원 범위와 제한 사항(중국어).

확장 보기에서 Silk Math Preview를 검색하거나 Visual Studio Marketplace 페이지에서 설치하세요. Windows, macOS, Linux를 지원하며 VS Code 1.95 이상이 필요합니다.

• 수식 자동 완성: 수식 안에서 인수 스니펫, 짝을 이루는 환경, 사용자 정의 매크로, 로컬 레이블·참조·문헌 키를 제공하며 저장하지 않은 수정도 반영합니다. silkMath.completion.mode를 언어별로 on(기본값), off, 엄격한 manual로 설정할 수 있으며 미리 보기에는 영향이 없습니다. 상태 메뉴의 “수식 자동 완성 모드…”에서 현재 언어의 모드를 설정할 수 있습니다. manual에서는 목록을 닫고 Ctrl+Space를 누르거나 Silk Math: Trigger Math Completion을 실행하세요. “수식 자동 완성 단축키…”에서 키를 바꿀 수 있습니다(silkMath.triggerCompletion). Silk 전용 단축키와 설정 항목은 manual에서만 활성화됩니다. on은 자동 완성과 VS Code 기본 키 동작을 유지합니다. 테스트 버전은 silkMathTest.*와 Ctrl+Alt+Shift+Space를 사용합니다. 선택적 인수 변형은 기본적으로 켜져 있습니다(completion.optionalArguments). completion.packages로 패키지 후보를 추가하고 completion.snippets로 명령을 덮어쓰거나 숨깁니다. 일반 본문, 이미지 경로, 주석, Markdown 코드는 제외됩니다. 동적 참조와 일부 TeX 명령에는 제한이 있으며 다른 확장 기능과 후보가 중복될 수 있습니다. 사용법과 제한 사항(중국어/영어).
• 미리 보기 켜기/끄기: Ctrl+Alt+M(Mac: ⌘⌥M)을 누르세요. Esc를 누르면 현재 미리 보기가 닫힙니다.
• 설정: 상태 표시줄의 Silk Math을 클릭해 미리 보기 크기와 사용할 파일 형식을 조정하세요. 다른 파일 형식은 기본적으로 꺼져 있습니다. 켜면 이름을 지정하지 않은 파일을 포함한 일반 텍스트에서도 LaTeX 수식을 인식합니다. **Silk Math → 파일 제외 규칙 편집…**에서 silkMath.preview.excludeFiles와 silkMath.completion.excludeFiles를 각각 편집합니다. 기본값은 모두 []입니다. *.tex는 모든 TeX 파일, notes.tex는 모든 디렉터리의 같은 이름 파일, chapters/draft.tex는 작업 영역 폴더 기준 상대 경로, 절대 경로는 해당 파일만 제외합니다. 대소문자를 구분하지 않으며 *, ?, 경로 구간 전체의 **를 지원합니다. 기존 silkMath.preview.excludeFileTypes와 silkMath.completion.excludeFileTypes에서도 확장자(.tex, .md, *.ipynb)와 언어 ID(latex, markdown)를 계속 사용할 수 있습니다. 상태 메뉴에서 현재 파일의 미리보기, 자동 완성 또는 둘 다 제외하거나 복원할 수 있으며 Notebook에서는 노트북 전체에 적용됩니다. 선택은 현재 작업 영역에 로컬로 저장됩니다. 복원 후에도 제외 규칙, 미리보기 설정 및 자동 완성 모드가 적용되며, 계속 제외하는 규칙이 있으면 메뉴에 표시됩니다. 규칙 편집 메뉴에는 항상 추가 항목이 표시됩니다. 기존 규칙을 선택해 수정하거나 비우고 확인해 삭제할 수 있습니다. 기본 저장 위치는 사용자 설정이며 작업 영역, 폴더 또는 언어별 범위로 변경할 수 있습니다. **Silk Math → 모든 바로 가기 키…**에서 화면 캡처 등 작업을 선택하면 VS Code에서 키를 추가하거나 변경할 수 있습니다. 기존 키 설정은 유지되며 Silk 완성 실행은 manual에서만 활성화됩니다.
• 이미지 복사: 오른쪽에 버튼 전용 26px 공간을 두어 스크롤 중에도 수식을 가리지 않습니다. 오른쪽 위 버튼으로 전체 수식을 흰 배경·검은 글자 PNG로 백그라운드에서 복사합니다. 편집 커서는 제외하고 스크롤 영역 밖도 포함하며 추가 페이지는 열지 않습니다. 클립보드 쓰기가 성공해야 아이콘이 부드럽게 체크 표시로 바뀌고 약 1.6초 후 복원됩니다. 동작 줄이기 설정을 따릅니다. Windows/macOS는 시스템 API를, Linux는 wl-copy(Wayland) 또는 xclip(X11)을 사용합니다.
• 미리 보기 CSS: Silk Math → 미리 보기 CSS 편집… 에서 수정하고 저장하면 적용됩니다. 내용을 비우고 저장하면 기본값으로 돌아갑니다. 넓거나 긴 수식은 글자 크기를 유지하며 떠 있는 미리 보기에서 상하·좌우로 스크롤할 수 있고, 스크롤바 손잡이는 5px입니다. 열거나 편집할 때 수식 커서 주변을 먼저 보여 주며, 수동 스크롤 위치는 다음 편집 또는 소스 커서 이동까지 유지됩니다. 모든 크기의 미리 보기는 선택한 위·아래·오른쪽을 유지하며(기본값: 아래), 공간이 부족해도 방향을 바꾸지 않습니다. 별도 줄 수식은 15% 작아지고 인라인 수식 크기는 그대로입니다. 모든 크기의 수식은 커서·선택 영역·전체 수식을 기준으로 위·아래·오른쪽 배치와 간격, 오프셋, 겹침을 설정할 수 있습니다. 글자 크기, 표시 영역 한도, 배경, 테두리, 그림자도 조정할 수 있습니다. 기본 안쪽 여백은 4px 8px, 모서리 반경은 6px이며 자동 완성, 호버 도움말, 모든 옵션의 중국어·영어 설명을 제공합니다. 정확한 경계는 호환되는 편집기 레이아웃에 따라 달라집니다. 스크롤, CSS 예시와 제한 사항(중국어·영어).
• TikZ / pgfplots: TikZ / pgfplots 실시간 미리보기(silkMath.tikz.enabled, 기본값은 꺼짐)를 켠 뒤 tikzpicture 안에 커서를 놓으세요. 저장하지 않은 수정 사항도 SVG에 반영됩니다. 처음 사용할 때 검증된 WebAssembly 렌더러를 다운로드하며, 이후에는 LaTeX 설치 없이 오프라인으로 사용할 수 있습니다. pgfplots 1.18.3이 포함되어 있으며 compat=1.18, 그룹 플롯, 플롯 라이브러리, TeX 고유의 매크로 정의를 지원합니다. 복잡한 그림은 시간이 더 걸릴 수 있으며, 완전한 TeX 배포판의 모든 기능을 제공하지는 않습니다. TikZ 사용법과 예시(중국어/영어).
• 스크린샷·이미지 인식(OCR): 상태 표시줄의 캡처 아이콘을 클릭하고 화면 영역을 드래그해 선택하세요. 마우스를 놓으면 인식이 시작되며, 간단한 메뉴에서 결과를 복사하거나 삽입하거나 편집할 수 있습니다. Silk Math → Recognize image…(이미지 인식)에서는 이미지를 붙여 넣거나 PNG / JPEG 파일을 선택할 수 있습니다. 모델은 처음 사용할 때 다운로드하며, 인식은 로컬에서 처리하고 이미지는 업로드하지 않습니다.
• OCR 단축키: Ctrl+Alt+O(Mac: ⌘⌥O)로 인식 메뉴를 열고, 메뉴 안에서 Ctrl+V(Mac: ⌘V)로 이미지를 붙여 넣으세요. 편집기에서 Ctrl+Alt+V(Mac: ⌘⌥V)를 누르면 클립보드 이미지를 바로 인식합니다. silkMath.ocr.pasteImages는 기본적으로 켜져 있어 LaTeX·Markdown 편집기에서 일반적인 이미지 붙여넣기로도 OCR을 실행할 수 있습니다. 편집기가 이미지 붙여넣기 API를 지원하지 않으면 인식 메뉴나 클립보드 인식 단축키를 사용하세요.
• OCR 정확도: 이미지 바깥쪽 여백을 잘라 내고 배경을 정리합니다. 결과가 불확실하면 한 번 더 인식합니다. 표 구조는 유지하지만 결과를 검토하라는 안내가 나올 수 있습니다. 복잡한 표, 손글씨, 흐릿한 이미지의 결과는 여전히 확인이 필요합니다. 인식 과정과 제한 사항(중국어).
• 테스트 버전: Ctrl+Alt+M/O/V(Mac: ⌘⌥M/O/V) 단축키에 Shift를 추가하세요. 테스트 버전은 별도의 silkMathTest.* 설정을 사용합니다. 이미지 붙여넣기 자동 인식은 기본적으로 꺼져 있으며 silkMathTest.ocr.pasteImages로 켤 수 있습니다. 같은 편집기에서 두 버전이 동시에 미리 보기를 제공하면 공유 팝업에서는 테스트 버전이 우선합니다.

정리 또는 proposition 환경 안의 수식은 개별적으로 미리 봅니다. 정리 본문과 번호는 조판하지 않습니다. 긴 문서에서도 수식 구분자의 문맥을 유지하며 LaTeX의 리터럴 코드가 주변 수식 경계에 영향을 주지 않습니다.

언어

Deutsch

Eine Erweiterung für Visual Studio Code, die LaTeX-Formeln während der Eingabe anzeigt. Öffnen Sie eine .tex-, Markdown-, MDX- oder Quarto-Datei oder ein Jupyter-Notebook (.ipynb) und setzen Sie den Cursor in eine Formel. Daneben erscheint eine schwebende MathJax-Vorschau; eine dünne orangefarbene Linie zeigt die aktuelle Eingabeposition. Sie müssen weder latexmk ausführen noch ein PDF erzeugen oder das Dokument kompilieren.

Unterstützt werden Formeln im Fließtext mit $...$ und \(...\), abgesetzte Formeln mit \[...\], Umgebungen wie equation, align und tabular sowie Tabellen in GitHub Flavored Markdown. Nicht definierte Befehle erscheinen rot; der übrige Teil der Formel wird weiterhin dargestellt.

Paketdeklarationen und lokale Abhängigkeiten werden automatisch erkannt, einschließlich gängiger eigener Makros aus .sty / .cls und ungespeicherter Änderungen in geöffneten Abhängigkeitsdateien. Zahlen- und Einheitenbefehle wie \num, \SI und \qty sowie eigene, im Textmodus verwendbare Makros funktionieren auch in Tabellenzellen. Unterstützte Makros und Einschränkungen (Chinesisch).

Suchen Sie in der Erweiterungsansicht nach Silk Math Preview oder öffnen Sie die Seite im Visual Studio Marketplace. Benötigt VS Code ab Version 1.95 unter Windows, macOS oder Linux.

• Mathematische Vervollständigung: In Formeln: Argument-Snippets, paarige Umgebungen, eigene Makros sowie lokale Label-, Verweis- und Literatur-Schlüssel, auch aus ungespeicherten Änderungen. silkMath.completion.mode unterstützt pro Sprache on (Standard), off und strikt manual, unabhängig von der Vorschau. Über „Mathematik-Vervollständigung…“ im Statusmenü stellen Sie den Modus für die aktuelle Sprache ein. In manual: bei geschlossener Liste Strg+Leertaste oder Silk Math: Trigger Math Completion; „Tastenkürzel für Mathe…“ ändert die Belegung (silkMath.triggerCompletion). Diese Silk-Kürzel und ihr Einstellungseintrag sind nur in manual aktiv. on behält automatische Vorschläge und die üblichen VS-Code-Tastenfunktionen bei. Testversion: silkMathTest.*, Strg+Alt+Umschalt+Leertaste. Optionale Argumentvarianten sind standardmäßig aktiv (completion.optionalArguments); completion.packages ergänzt Paketvorschläge, completion.snippets überschreibt oder versteckt Befehle. Fließtext, Bildpfade, Kommentare und Markdown-Code sind ausgenommen. Dynamische Verweise und einige TeX-Befehle bleiben eingeschränkt; andere Erweiterungen können doppelte Vorschläge liefern. Anleitung und Grenzen (Chinesisch / Englisch).
• Vorschau ein-/ausschalten: Strg+Alt+M (Mac: ⌘⌥M). Mit Esc schließen Sie die aktuelle Vorschau.
• Einstellungen: Klicken Sie in der Statusleiste auf Silk Math, um die Vorschaugröße und die aktivierten Dateitypen anzupassen. Andere Dateitypen ist standardmäßig deaktiviert. Nach dem Einschalten werden LaTeX-Formeln auch in reinen Textdateien erkannt, einschließlich unbenannter Dateien. Silk Math → Dateiausschlüsse bearbeiten… öffnet silkMath.preview.excludeFiles und silkMath.completion.excludeFiles, beide standardmäßig []. *.tex schließt alle TeX-Dateien aus, notes.tex diesen Dateinamen in jedem Ordner. chapters/draft.tex ist relativ zum Workspace-Ordner; ein absoluter Pfad betrifft nur die angegebene Datei. Die Muster unterscheiden nicht zwischen Groß- und Kleinschreibung und unterstützen *, ? sowie ** als vollständigen Pfadabschnitt. silkMath.preview.excludeFileTypes und silkMath.completion.excludeFileTypes akzeptieren weiterhin Endungen (.tex, .md, *.ipynb) oder Sprach-IDs (latex, markdown). Im Statusmenü lassen sich Vorschau, Vervollständigung oder beide für die aktuelle Datei ausschließen und wiederherstellen; bei Notebooks gilt dies für das gesamte Notebook. Die Auswahl wird lokal im Workspace gespeichert. Ausschlussregeln, Vorschau-Einstellungen und Vervollständigungsmodus gelten nach dem Wiederherstellen weiterhin; das Menü zeigt verbleibende Ausschlussregeln an. Im Regelmenü sind die Einträge zum Hinzufügen immer sichtbar. Vorhandene Regeln lassen sich auswählen, bearbeiten oder durch Leeren löschen. Neue Regeln gelten zunächst für den Benutzer; Workspace, Ordner und sprachspezifische Einstellungen sind ebenfalls wählbar. Silk Math → Alle Tastenkombinationen… führt auch Bildschirmaufnahmen auf: Aktion wählen und die Tasten in VS Code zuweisen. Vorhandene Belegungen bleiben erhalten; Silks Vervollständigungsbefehl gilt nur in manual.
• Bild kopieren: Ein eigener 26px breiter Bereich rechts hält die Schaltfläche auch beim Scrollen von der Formel frei. Oben rechts die vollständige Formel als PNG mit schwarzer Schrift auf weißem Hintergrund kopieren, ohne Bearbeitungscursor oder abgeschnittenen Scrollbereich. Alles läuft im Hintergrund, ohne zusätzliche Seite. Erst nach erfolgreichem Schreiben in die Zwischenablage erscheint ein sanft animiertes Häkchen; nach 1,6 Sekunden kehrt das Kopiersymbol zurück. Reduzierte Bewegung wird berücksichtigt. Windows/macOS nutzen System-APIs; Linux benötigt wl-copy (Wayland) oder xclip (X11).
• Vorschau-CSS: Unter Silk Math → Vorschau-CSS bearbeiten… ändern und speichern; zum Zurücksetzen leeren und speichern. Überbreite oder hohe Formeln behalten ihre Schriftgröße und lassen sich im schwebenden Fenster horizontal und vertikal scrollen; die Scrollgriffe sind 5px schmal. Beim Öffnen oder Bearbeiten wird die Umgebung des Formelcursors angezeigt. Manuelles Scrollen bleibt bis zur nächsten Eingabe oder Cursorbewegung erhalten. Alle Vorschaugrößen halten die gewählte Seite oben/unten/rechts strikt ein (Standard: unten), auch bei Platzmangel. Abgesetzte Formeln sind 15% kleiner; Inline-Formeln bleiben unverändert. Für alle Formelgrößen sind Cursor, Auswahl oder Gesamtformel als Bezug sowie Platzierung oben/unten/rechts, Abstand, Versatz und Überlappung einstellbar. Schriftgröße, Fenstergrenzen, Hintergrund, Rahmen und Schatten sind anpassbar. Standard: 4px 8px Innenabstand und 6px Eckenradius. Ergänzung, Hover-Hilfe und alle Optionen sind chinesisch/englisch erklärt. Genaue Grenzen erfordern ein kompatibles Editorlayout. Scrollen, CSS-Beispiele und Grenzen (Chinesisch / Englisch).
• TikZ / pgfplots: Aktivieren Sie TikZ / pgfplots Live-Vorschau (silkMath.tikz.enabled, standardmäßig aus) und setzen Sie den Cursor in eine tikzpicture-Umgebung. Auch ungespeicherte Änderungen aktualisieren das SVG. Beim ersten Einsatz wird ein auf Integrität geprüfter WebAssembly-Renderer heruntergeladen; danach funktioniert die Vorschau offline ohne LaTeX-Installation. Enthalten sind pgfplots 1.18.3, compat=1.18, gruppierte Diagramme, Diagrammbibliotheken und native Makrodefinitionen. Komplexe Grafiken können länger dauern; der Funktionsumfang entspricht keiner vollständigen TeX-Distribution. TikZ-Anleitung und Beispiele (Chinesisch / Englisch).
• Bildschirm- und Bilderkennung (OCR): Klicken Sie auf das Aufnahmesymbol in der Statusleiste und ziehen Sie einen Auswahlrahmen auf dem Bildschirm. Sobald Sie die Maustaste loslassen, beginnt die Erkennung. In einem kompakten Menü können Sie das Ergebnis kopieren, einfügen oder bearbeiten. Unter Silk Math → Recognize image… (Bild erkennen) können Sie ein Bild aus der Zwischenablage einfügen oder eine PNG-/JPEG-Datei auswählen. Die Modelle werden beim ersten Einsatz heruntergeladen und lokal ausgeführt; Bilder werden nicht hochgeladen.
• OCR-Tastenkürzel: Strg+Alt+O (Mac: ⌘⌥O) öffnet das Erkennungsmenü. Dort fügen Sie mit Strg+V (Mac: ⌘V) ein Bild ein. Im Editor erkennt Strg+Alt+V (Mac: ⌘⌥V) direkt das Bild in der Zwischenablage. Mit silkMath.ocr.pasteImages (standardmäßig aktiviert) löst auch das normale Einfügen eines Bildes in LaTeX- und Markdown-Editoren die Erkennung aus. Fehlt Ihrem Editor die API zum Einfügen von Bildern, verwenden Sie das Erkennungsmenü oder das Tastenkürzel für die Zwischenablage.
• OCR-Genauigkeit: Äußere Leerflächen werden zugeschnitten und der Hintergrund vereinheitlicht. Bei fragwürdigen Ergebnissen erfolgt ein weiterer Erkennungsversuch. Tabellenstrukturen bleiben erhalten; Ergebnisse können jedoch zur Überprüfung markiert werden. Komplexe Tabellen, Handschrift und unscharfe Bilder sollten Sie weiterhin prüfen. Erkennungsverfahren und Einschränkungen (Chinesisch).
• Testversion: Ergänzen Sie die Tastenkürzel Strg+Alt+M/O/V (Mac: ⌘⌥M/O/V) um Shift (Umschalt). Die Testversion verwendet separate Einstellungen unter silkMathTest.*. Die automatische Bilderkennung beim Einfügen ist standardmäßig deaktiviert und lässt sich mit silkMathTest.ocr.pasteImages aktivieren. Wenn beide Versionen im selben Editor Vorschauen liefern, hat die Testversion im gemeinsamen schwebenden Fenster Vorrang.

Formeln in Theorem- oder proposition-Umgebungen werden einzeln angezeigt; Theoremtext und Nummerierung werden nicht gesetzt. Auch lange Dokumente behalten den Kontext der Mathematikbegrenzer. Wörtlicher LaTeX-Code verändert die Grenzen umgebender Formeln nicht.

Sprachen

Français

Une extension pour Visual Studio Code qui affiche vos formules LaTeX au fil de la saisie. Ouvrez un fichier .tex, Markdown, MDX ou Quarto, ou un notebook Jupyter (.ipynb), puis placez le curseur dans une formule. Un aperçu flottant MathJax apparaît à côté ; un fin trait orange indique la position de saisie. Inutile de lancer latexmk, de générer un PDF ou de compiler le document.

L’extension prend en charge les formules dans le texte avec $...$ et \(...\), les formules sur une ligne séparée avec \[...\], les environnements comme equation, align et tabular, ainsi que les tableaux GitHub Flavored Markdown. Les commandes non définies apparaissent en rouge ; le reste de la formule continue de s’afficher.

Les déclarations de packages et les dépendances locales sont détectées automatiquement, y compris les macros personnalisées courantes des fichiers .sty / .cls et les modifications non enregistrées dans les fichiers de dépendances ouverts. Les commandes de nombres et d’unités telles que \num, \SI et \qty, ainsi que les macros personnalisées utilisables en mode texte, fonctionnent aussi dans les cellules des tableaux. Macros prises en charge et limites (en chinois).

Recherchez Silk Math Preview dans la vue Extensions, ou consultez la fiche Visual Studio Marketplace. Nécessite VS Code 1.95 ou une version ultérieure, sous Windows, macOS ou Linux.

• Complétion mathématique : Dans les formules : snippets avec arguments, environnements appariés, macros personnalisées et clés locales de labels, références et citations, y compris les modifications non enregistrées. silkMath.completion.mode propose par langage on (par défaut), off et manual strict, indépendamment de l’aperçu. Choisissez « Mode de complétion mathématique… » dans le menu de la barre d’état pour régler le langage actuel. En manual : Ctrl+Espace avec la liste fermée ou Silk Math: Trigger Math Completion ; « Raccourci de complétion mathématique… » change les touches (silkMath.triggerCompletion). Ces raccourcis Silk et leur entrée de réglage sont actifs uniquement en manual. on conserve les suggestions automatiques et le comportement habituel des touches de VS Code. Version de test : silkMathTest.*, Ctrl+Alt+Maj+Espace. Les variantes d’arguments facultatifs sont activées par défaut (completion.optionalArguments) ; completion.packages ajoute des propositions de paquets, completion.snippets remplace ou masque des commandes. Texte courant, chemins d’images, commentaires et code Markdown sont exclus. Les références dynamiques et certaines commandes TeX restent limitées ; des doublons avec d’autres extensions sont possibles. Guide et limites (chinois / anglais).
• Activer ou désactiver l’aperçu : Ctrl+Alt+M (Mac : ⌘⌥M). Appuyez sur Esc pour fermer l’aperçu actuel.
• Paramètres : Cliquez sur Silk Math dans la barre d’état pour régler la taille de l’aperçu et les types de fichiers concernés. L’option Autres types de fichiers est désactivée par défaut ; activez-la pour reconnaître les formules LaTeX dans les fichiers texte brut, y compris ceux sans titre. Silk Math → Modifier les règles d’exclusion… ouvre silkMath.preview.excludeFiles et silkMath.completion.excludeFiles, tous deux vides ([]) par défaut. *.tex exclut tous les fichiers TeX, notes.tex tous les fichiers portant ce nom. chapters/draft.tex est relatif au dossier de l’espace de travail ; un chemin absolu ne vise que le fichier indiqué. Les motifs ignorent la casse et acceptent *, ? et ** comme segment entier. silkMath.preview.excludeFileTypes et silkMath.completion.excludeFileTypes acceptent toujours les extensions (.tex, .md, *.ipynb) ou identifiants de langage (latex, markdown). Le menu de la barre d’état permet d’exclure ou de rétablir l’aperçu, la complétion ou les deux pour le fichier courant, ou pour le notebook entier. Ces choix restent locaux à l’espace de travail. Après rétablissement, les règles d’exclusion, les réglages d’aperçu et le mode de complétion restent applicables ; le menu indique la règle qui exclut encore le fichier. Le menu des règles propose toujours l’ajout ; sélectionnez une règle pour la modifier, ou videz-la pour la supprimer. Les nouvelles règles vont par défaut dans les paramètres utilisateur ; l’espace de travail, le dossier et la langue sont aussi disponibles. Silk Math → Tous les raccourcis clavier… liste toutes les actions, dont la capture d’écran : choisissez-en une pour définir ses touches dans VS Code. Les raccourcis existants sont conservés ; le déclenchement Silk reste réservé à manual.
• Copier l’image : Une zone réservée de 26px à droite évite que le bouton masque la formule, même pendant le défilement. Le bouton en haut à droite copie toute la formule en PNG, en noir sur fond blanc, sans curseur ni contenu tronqué. Tout se fait en arrière-plan, sans page supplémentaire. Une coche animée apparaît uniquement après la réussite de l’écriture dans le presse-papiers, puis l’icône revient après 1,6 seconde. Le réglage de réduction des animations est respecté. Windows/macOS utilisent les API système ; Linux nécessite wl-copy (Wayland) ou xclip (X11).
• CSS de l’aperçu : Ouvrez Silk Math → Modifier le CSS de l’aperçu…, puis enregistrez pour appliquer ; effacez et enregistrez pour rétablir les valeurs par défaut. Les formules trop larges ou hautes gardent leur taille de police dans une fenêtre flottante à défilement horizontal et vertical, avec des curseurs de barre de 5px. À l’ouverture ou pendant la saisie, l’aperçu montre les environs du curseur mathématique. Le défilement manuel reste en place jusqu’à la prochaine modification ou au déplacement du curseur source. Toutes les tailles respectent le côté choisi (dessus/dessous/droite, dessous par défaut), même si l’espace manque. Les formules hors ligne sont 15% plus petites ; celles en ligne restent inchangées. Pour toutes les tailles de formules, choisissez curseur/sélection/formule comme repère, une position au-dessus/en dessous/à droite, l’écart, le décalage et le chevauchement. Police, limites de fenêtre, fond, bordure et ombre sont réglables. Valeurs par défaut : marge 4px 8px, rayon 6px. Complétion, aide au survol et explications de tous les paramètres sont proposées en chinois/anglais. Les limites précises dépendent d’une disposition compatible de l’éditeur. Défilement, exemples CSS et limites (chinois / anglais).
• TikZ / pgfplots : Activez Aperçu TikZ / pgfplots en direct (silkMath.tikz.enabled, désactivé par défaut), puis placez le curseur dans un environnement tikzpicture. Les modifications actualisent le SVG sans avoir à enregistrer. La première utilisation télécharge un moteur de rendu WebAssembly dont l’intégrité est vérifiée ; les suivantes fonctionnent hors ligne, sans installation de LaTeX. L’extension inclut pgfplots 1.18.3, compat=1.18, les graphiques groupés, les bibliothèques de tracé et les définitions de macros natives. Les figures complexes peuvent prendre plus de temps ; il ne s’agit pas d’une distribution TeX complète. Guide TikZ et exemples (en chinois et en anglais).
• Reconnaissance de captures et d’images (OCR) : Cliquez sur l’icône de capture dans la barre d’état, puis sélectionnez une zone de l’écran en faisant glisser la souris. La reconnaissance démarre au relâchement du bouton. Un menu compact permet de copier, d’insérer ou de modifier le résultat. Choisissez Silk Math → Recognize image… (reconnaître une image) pour coller une image ou sélectionner un fichier PNG / JPEG. Les modèles sont téléchargés à la première utilisation et s’exécutent localement ; les images ne sont pas envoyées en ligne.
• Raccourcis OCR : Ctrl+Alt+O (Mac : ⌘⌥O) ouvre le menu de reconnaissance, où Ctrl+V (Mac : ⌘V) colle une image. Dans l’éditeur, Ctrl+Alt+V (Mac : ⌘⌥V) reconnaît directement l’image du presse-papiers. L’option silkMath.ocr.pasteImages, activée par défaut, déclenche aussi l’OCR lors d’un collage d’image classique dans les éditeurs LaTeX et Markdown. Si votre éditeur ne dispose pas de l’API de collage d’images, utilisez le menu de reconnaissance ou le raccourci du presse-papiers.
• Précision de l’OCR : Les marges vides sont rognées et le fond est uniformisé. Les résultats douteux font l’objet d’une seconde tentative de reconnaissance. La structure des tableaux est conservée, mais une vérification peut être demandée. Les tableaux complexes, l’écriture manuscrite et les images floues nécessitent toujours une relecture. Fonctionnement et limites de la reconnaissance (en chinois).
• Version de test : Ajoutez Shift (Maj) aux raccourcis Ctrl+Alt+M/O/V (Mac : ⌘⌥M/O/V). Cette version utilise des paramètres distincts sous silkMathTest.*. La reconnaissance automatique au collage d’une image est désactivée par défaut ; vous pouvez l’activer avec silkMathTest.ocr.pasteImages. Si les deux versions proposent un aperçu dans le même éditeur, la version de test est prioritaire dans la fenêtre flottante partagée.

Les formules dans les environnements de théorème ou proposition sont prévisualisées séparément ; le texte et la numérotation du théorème ne sont pas composés. Le contexte des délimiteurs est conservé dans les longs documents et le code LaTeX littéral ne perturbe pas les formules voisines.

Langues

Español

Una extensión para Visual Studio Code que muestra tus fórmulas LaTeX mientras escribes. Abre un archivo .tex, Markdown, MDX o Quarto, o un cuaderno de Jupyter (.ipynb), y coloca el cursor dentro de una fórmula. A su lado aparece una vista previa flotante de MathJax; una fina línea naranja indica dónde estás escribiendo. No hace falta ejecutar latexmk, generar un PDF ni compilar el documento.

Admite fórmulas en línea con $...$ y \(...\), fórmulas en una línea independiente con \[...\], entornos como equation, align y tabular, y tablas de GitHub Flavored Markdown. Los comandos no definidos aparecen en rojo y el resto de la fórmula sigue mostrándose.

Detecta automáticamente las declaraciones de paquetes y las dependencias locales, incluidas las macros personalizadas habituales de archivos .sty / .cls y los cambios sin guardar en archivos de dependencias abiertos. Los comandos de números y unidades como \num, \SI y \qty, así como las macros personalizadas que pueden usarse en modo texto, también funcionan en las celdas de las tablas. Macros compatibles y limitaciones (en chino).

Busca Silk Math Preview en la vista Extensiones o visita la página de Visual Studio Marketplace. Requiere VS Code 1.95 o posterior en Windows, macOS o Linux.

• Autocompletado matemático: En las fórmulas: snippets con argumentos, entornos emparejados, macros personalizadas y claves locales de etiquetas, referencias y citas, incluidos cambios sin guardar. silkMath.completion.mode admite por lenguaje on (predeterminado), off y manual estricto, sin afectar a la vista previa. Elige «Modo de completado matemático…» en el menú de estado para configurar el lenguaje actual. En manual: Ctrl+Espacio con la lista cerrada o Silk Math: Trigger Math Completion; «Atajo de completado matemático…» cambia las teclas (silkMath.triggerCompletion). Estos atajos de Silk y su opción de configuración solo están activos en manual. on mantiene las sugerencias automáticas y las teclas habituales de VS Code. Versión de prueba: silkMathTest.*, Ctrl+Alt+Mayús+Espacio. Las variantes con argumentos opcionales están activadas por defecto (completion.optionalArguments); completion.packages añade candidatos de paquetes, completion.snippets sustituye u oculta comandos. Se excluyen texto normal, rutas de imágenes, comentarios y código Markdown. Las referencias dinámicas y algunos comandos TeX tienen limitaciones; puede haber duplicados con otras extensiones. Guía y límites (chino / inglés).
• Activar o desactivar la vista previa: Ctrl+Alt+M (Mac: ⌘⌥M). Pulsa Esc para cerrar la vista previa actual.
• Configuración: Haz clic en Silk Math en la barra de estado para ajustar el tamaño de la vista previa y los tipos de archivo habilitados. Otros tipos de archivo está desactivado de forma predeterminada; actívalo para reconocer fórmulas LaTeX en texto sin formato, incluidos los archivos sin título. Silk Math → Editar reglas de exclusión… abre silkMath.preview.excludeFiles y silkMath.completion.excludeFiles, ambos vacíos ([]) de forma predeterminada. *.tex excluye todos los archivos TeX; notes.tex, ese nombre en cualquier carpeta. chapters/draft.tex es relativo a la carpeta del espacio de trabajo; una ruta absoluta solo afecta a ese archivo. Los patrones no distinguen mayúsculas y admiten *, ? y ** como segmento completo. silkMath.preview.excludeFileTypes y silkMath.completion.excludeFileTypes siguen aceptando extensiones (.tex, .md, *.ipynb) o identificadores de lenguaje (latex, markdown). El menú de estado permite excluir o restaurar la vista previa, el autocompletado o ambos para el archivo actual; en notebooks se aplica al cuaderno completo. Las elecciones se guardan localmente en el espacio de trabajo. Al restaurar, siguen vigentes las reglas de exclusión, los ajustes de vista previa y el modo de autocompletado; el menú muestra la regla que aún excluye el archivo. El menú de reglas siempre permite añadir entradas; selecciona una para editarla o vacíala para eliminarla. Las reglas nuevas se guardan en los ajustes de usuario por defecto; también puedes elegir el espacio de trabajo, la carpeta o el lenguaje. Silk Math → Todos los atajos de teclado… incluye todas las acciones, como las capturas: elige una para asignar sus teclas en VS Code. Se conservan los atajos existentes; el comando de completado de Silk solo funciona en manual.
• Copiar imagen: Una zona exclusiva de 26px a la derecha evita que el botón tape la fórmula, incluso al desplazarse. El botón superior derecho copia toda la fórmula como PNG con letras negras y fondo blanco, sin cursor ni contenido recortado. Funciona en segundo plano y no abre otra página. Solo tras escribir correctamente en el portapapeles aparece una marca animada; el icono vuelve tras 1,6 segundos. Respeta la preferencia de movimiento reducido. Windows/macOS usan las API del sistema; Linux requiere wl-copy (Wayland) o xclip (X11).
• CSS de la vista previa: Abre Silk Math → Editar CSS de la vista previa… y guarda para aplicar; borra y guarda para restablecer. Las fórmulas demasiado anchas o altas conservan su tamaño de letra en una ventana flotante con desplazamiento horizontal y vertical y tiradores de 5px. Al abrir o editar, se muestra el entorno del cursor matemático; el desplazamiento manual se conserva hasta la siguiente edición o movimiento del cursor del código. Todos los tamaños respetan el lado elegido (encima/debajo/derecha, debajo por defecto), incluso si falta espacio. Las fórmulas en bloque son un 15% más pequeñas; las fórmulas en línea no cambian. Para fórmulas de cualquier tamaño, elige cursor/selección/fórmula como referencia, posición encima/debajo/a la derecha, separación, desplazamiento y superposición. Ajusta letra, límites de ventana, fondo, borde y sombra. Valores predeterminados: relleno 4px 8px y radio 6px. Hay autocompletado, ayuda al pasar el cursor y explicaciones de todas las opciones en chino e inglés. Los límites exactos dependen de un diseño compatible del editor. Desplazamiento, ejemplos CSS y límites (chino / inglés).
• TikZ / pgfplots: Activa Vista previa de TikZ / pgfplots (silkMath.tikz.enabled, desactivada de forma predeterminada) y coloca el cursor en un entorno tikzpicture. Los cambios actualizan el SVG sin necesidad de guardar. En el primer uso se descarga un motor de renderizado WebAssembly cuya integridad se verifica; después funciona sin conexión y sin instalar LaTeX. Incluye pgfplots 1.18.3, compat=1.18, gráficos agrupados, bibliotecas de gráficos y definiciones de macros nativas. Las figuras complejas pueden tardar más; no equivale a una distribución completa de TeX. Guía de TikZ y ejemplos (en chino e inglés).
• Reconocimiento de capturas e imágenes (OCR): Haz clic en el icono de captura de la barra de estado y arrastra para seleccionar una zona de la pantalla. El reconocimiento comienza al soltar el botón del ratón. Un menú compacto permite copiar, insertar o editar el resultado. Selecciona Silk Math → Recognize image… (reconocer imagen) para pegar una imagen o elegir un archivo PNG / JPEG. Los modelos se descargan en el primer uso y se ejecutan localmente; las imágenes no se suben a ningún servidor.
• Atajos de OCR: Ctrl+Alt+O (Mac: ⌘⌥O) abre el menú de reconocimiento, donde puedes pegar una imagen con Ctrl+V (Mac: ⌘V). En el editor, Ctrl+Alt+V (Mac: ⌘⌥V) reconoce directamente la imagen del portapapeles. Con silkMath.ocr.pasteImages, activado de forma predeterminada, pegar una imagen normalmente en los editores LaTeX y Markdown también inicia el OCR. Si tu editor no dispone de la API para pegar imágenes, usa el menú de reconocimiento o el atajo del portapapeles.
• Precisión del OCR: Se recortan los márgenes vacíos y se uniformiza el fondo; los resultados dudosos se vuelven a reconocer una vez. Se conserva la estructura de las tablas, aunque puede solicitarse una revisión. Las tablas complejas, la escritura a mano y las imágenes borrosas siguen necesitando comprobación. Proceso de reconocimiento y limitaciones (en chino).
• Versión de prueba: Añade Shift (Mayús) a los atajos Ctrl+Alt+M/O/V (Mac: ⌘⌥M/O/V). Esta versión usa una configuración independiente bajo silkMathTest.*. El reconocimiento automático al pegar imágenes está desactivado de forma predeterminada y se puede activar con silkMathTest.ocr.pasteImages. Si ambas versiones ofrecen una vista previa en el mismo editor, la versión de prueba tiene prioridad en la ventana flotante compartida.

Las fórmulas dentro de entornos de teorema o proposition se previsualizan por separado; no se compone el texto ni la numeración del teorema. Los documentos largos conservan el contexto de los delimitadores y el código LaTeX literal no altera los límites de las fórmulas cercanas.

Idiomas

Português

Uma extensão para Visual Studio Code que mostra suas fórmulas LaTeX enquanto você digita. Abra um arquivo .tex, Markdown, MDX ou Quarto, ou um notebook Jupyter (.ipynb), e posicione o cursor dentro de uma fórmula. Uma prévia flutuante do MathJax aparece ao lado, com uma linha fina laranja indicando a posição de digitação. Não é preciso executar latexmk, gerar um PDF nem compilar o documento.

Oferece suporte a fórmulas no texto com $...$ e \(...\), fórmulas em uma linha separada com \[...\], ambientes como equation, align e tabular, além de tabelas do GitHub Flavored Markdown. Comandos não definidos aparecem em vermelho, enquanto o restante da fórmula continua sendo exibido.

As declarações de pacotes e as dependências locais são detectadas automaticamente, incluindo macros personalizadas comuns em arquivos .sty / .cls e alterações não salvas em arquivos de dependências abertos. Comandos de números e unidades como \num, \SI e \qty, assim como macros personalizadas que funcionam no modo de texto, também podem ser usados nas células das tabelas. Macros compatíveis e limitações (em chinês).

Pesquise Silk Math Preview na visualização Extensões ou acesse a página do Visual Studio Marketplace. Requer VS Code 1.95 ou mais recente no Windows, macOS ou Linux.

• Preenchimento automático de matemática: Nas fórmulas: snippets com argumentos, ambientes em pares, macros personalizadas e chaves locais de rótulos, referências e citações, incluindo alterações não salvas. silkMath.completion.mode oferece por linguagem on (padrão), off e manual estrito, sem afetar a prévia. Escolha “Modo de preenchimento matemático…” no menu da barra de status para configurar a linguagem atual. Em manual: Ctrl+Espaço com a lista fechada ou Silk Math: Trigger Math Completion; “Atalho de preenchimento matemático…” altera as teclas (silkMath.triggerCompletion). Esses atalhos do Silk e sua opção de configuração só ficam ativos em manual. on mantém as sugestões automáticas e o comportamento normal das teclas do VS Code. Versão de teste: silkMathTest.*, Ctrl+Alt+Shift+Espaço. Variantes com argumentos opcionais ficam ativadas por padrão (completion.optionalArguments); completion.packages adiciona sugestões de pacotes, completion.snippets substitui ou oculta comandos. Texto comum, caminhos de imagens, comentários e código Markdown ficam de fora. Referências dinâmicas e alguns comandos TeX têm limitações; outras extensões podem fornecer sugestões duplicadas. Guia e limites (chinês / inglês).
• Ativar ou desativar a prévia: Ctrl+Alt+M (Mac: ⌘⌥M). Pressione Esc para fechar a prévia atual.
• Configurações: Clique em Silk Math na barra de status para ajustar o tamanho da prévia e os tipos de arquivo habilitados. Outros tipos de arquivo vem desativado; ative essa opção para reconhecer fórmulas LaTeX em texto simples, incluindo arquivos sem título. Silk Math → Editar regras de exclusão… abre silkMath.preview.excludeFiles e silkMath.completion.excludeFiles, ambos vazios ([]) por padrão. *.tex exclui todos os arquivos TeX; notes.tex, esse nome em qualquer pasta. chapters/draft.tex é relativo à pasta do espaço de trabalho; um caminho absoluto afeta apenas aquele arquivo. Os padrões não diferenciam maiúsculas de minúsculas e aceitam *, ? e ** como segmento inteiro. silkMath.preview.excludeFileTypes e silkMath.completion.excludeFileTypes continuam aceitando extensões (.tex, .md, *.ipynb) ou IDs de linguagem (latex, markdown). O menu da barra de status permite excluir ou restaurar a prévia, o preenchimento automático ou ambos no arquivo atual; em notebooks, vale para o notebook inteiro. As escolhas ficam salvas localmente no espaço de trabalho. Ao restaurar, continuam valendo as regras de exclusão, as opções de prévia e o modo de preenchimento automático; o menu mostra a regra que ainda exclui o arquivo. O menu de regras sempre oferece a opção de adicionar; selecione uma regra para editar ou limpe seu conteúdo para excluir. Novas regras vão para as configurações do usuário por padrão; também é possível escolher espaço de trabalho, pasta ou linguagem. Silk Math → Todos os atalhos de teclado… lista todas as ações, incluindo captura de tela: escolha uma e atribua suas teclas no VS Code. Os atalhos existentes são preservados; o comando de preenchimento do Silk só funciona em manual.
• Copiar imagem: Uma área exclusiva de 26px à direita impede que o botão cubra a fórmula, mesmo durante a rolagem. O botão superior direito copia a fórmula inteira como PNG em preto no branco, sem cursor ou conteúdo cortado. Tudo ocorre em segundo plano, sem abrir outra página. Uma marca animada aparece somente após a gravação bem-sucedida na área de transferência; o ícone volta após 1,6 segundo. Respeita a preferência de movimento reduzido. Windows/macOS usam as APIs do sistema; Linux requer wl-copy (Wayland) ou xclip (X11).
• CSS da prévia: Abra Silk Math → Editar CSS da prévia… e salve para aplicar; apague e salve para restaurar. Fórmulas largas ou altas mantêm o tamanho da fonte em uma janela flutuante com rolagem horizontal e vertical e indicadores de 5px. Ao abrir ou editar, a prévia mostra a região do cursor matemático; a rolagem manual permanece até a próxima edição ou movimento do cursor no código. Todos os tamanhos respeitam o lado escolhido (acima/abaixo/direita, abaixo por padrão), mesmo sem espaço suficiente. Fórmulas em bloco ficam 15% menores; fórmulas em linha não mudam. Para fórmulas de qualquer tamanho, escolha cursor/seleção/fórmula como referência, posição acima/abaixo/à direita, espaçamento, deslocamento e sobreposição. Ajuste fonte, limites da janela, fundo, borda e sombra. Padrões: espaçamento interno 4px 8px e raio 6px. Há preenchimento automático, ajuda ao passar o mouse e explicações de todas as opções em chinês e inglês. Os limites exatos dependem de um layout compatível do editor. Rolagem, exemplos CSS e limites (chinês / inglês).
• TikZ / pgfplots: Ative Prévia ao vivo de TikZ / pgfplots (silkMath.tikz.enabled, desativada por padrão) e posicione o cursor em um ambiente tikzpicture. As alterações atualizam o SVG mesmo antes de salvar. No primeiro uso, é baixado um renderizador WebAssembly com verificação de integridade; depois, ele funciona offline, sem instalar LaTeX. Inclui pgfplots 1.18.3, compat=1.18, gráficos agrupados, bibliotecas de gráficos e definições de macros nativas. Figuras complexas podem levar mais tempo; os recursos não equivalem aos de uma distribuição TeX completa. Guia de TikZ e exemplos (em chinês e inglês).
• Reconhecimento de capturas e imagens (OCR): Clique no ícone de captura da barra de status e arraste para selecionar uma área da tela. O reconhecimento começa ao soltar o botão do mouse. Um menu compacto permite copiar, inserir ou editar o resultado. Escolha Silk Math → Recognize image… (reconhecer imagem) para colar uma imagem ou selecionar um arquivo PNG / JPEG. Os modelos são baixados no primeiro uso e executados localmente; as imagens não são enviadas a servidores.
• Atalhos de OCR: Ctrl+Alt+O (Mac: ⌘⌥O) abre o menu de reconhecimento, onde você pode colar uma imagem com Ctrl+V (Mac: ⌘V). No editor, Ctrl+Alt+V (Mac: ⌘⌥V) reconhece diretamente a imagem da área de transferência. Com silkMath.ocr.pasteImages, ativado por padrão, colar uma imagem normalmente nos editores LaTeX e Markdown também inicia o OCR. Se o editor não oferecer a API para colar imagens, use o menu de reconhecimento ou o atalho da área de transferência.
• Precisão do OCR: As margens vazias são recortadas e o fundo é uniformizado; resultados duvidosos passam por mais uma tentativa de reconhecimento. A estrutura das tabelas é preservada, mas o resultado pode ser sinalizado para revisão. Tabelas complexas, escrita à mão e imagens desfocadas ainda precisam ser conferidas. Processo de reconhecimento e limitações (em chinês).
• Versão de teste: Acrescente Shift aos atalhos Ctrl+Alt+M/O/V (Mac: ⌘⌥M/O/V). Essa versão usa configurações independentes em silkMathTest.*. O reconhecimento automático ao colar imagens vem desativado e pode ser ativado com silkMathTest.ocr.pasteImages. Se as duas versões oferecerem prévia no mesmo editor, a versão de teste terá prioridade na janela flutuante compartilhada.

As fórmulas em ambientes de teorema ou proposition são pré-visualizadas individualmente; o texto e a numeração do teorema não são compostos. Documentos longos preservam o contexto dos delimitadores, e o código LaTeX literal não interfere nos limites das fórmulas próximas.

Idiomas

Русский

Расширение для Visual Studio Code, которое показывает формулы LaTeX по мере ввода. Откройте файл .tex, Markdown, MDX или Quarto либо блокнот Jupyter (.ipynb) и установите курсор внутри формулы. Рядом появится всплывающий предпросмотр MathJax, а тонкая оранжевая линия укажет текущую позицию ввода. Запускать latexmk, создавать PDF или компилировать документ не нужно.

Поддерживаются формулы внутри строки с $...$ и \(...\), формулы на отдельной строке с \[...\], окружения equation, align и tabular, а также таблицы GitHub Flavored Markdown. Неопределённые команды выделяются красным; остальная часть формулы продолжает отображаться.

Объявления пакетов и локальные зависимости определяются автоматически, включая распространённые пользовательские макросы из .sty / .cls и несохранённые изменения в открытых файлах зависимостей. Команды для чисел и единиц измерения, например \num, \SI и \qty, а также пользовательские макросы, доступные в текстовом режиме, работают и в ячейках таблиц. Поддержка макросов и ограничения (на китайском).

Найдите Silk Math Preview в разделе расширений или откройте страницу Visual Studio Marketplace. Требуется VS Code 1.95 или новее под Windows, macOS или Linux.

• Математическое автодополнение: В формулах: сниппеты с аргументами, парные окружения, пользовательские макросы и локальные ключи меток, ссылок и цитат, включая несохранённые изменения. silkMath.completion.mode задаётся по языку: on (по умолчанию), off или строгий manual, независимо от предпросмотра. Выберите «Режим автодополнения формул…» в меню строки состояния для текущего языка. В manual: Ctrl+Пробел при закрытом списке или Silk Math: Trigger Math Completion; «Клавиши автодополнения формул…» позволяет изменить клавиши (silkMath.triggerCompletion). Эти сочетания Silk и пункт их настройки доступны только в manual. В on сохраняются автоматические подсказки и обычные действия клавиш VS Code. Тестовая версия: silkMathTest.*, Ctrl+Alt+Shift+Пробел. Варианты с необязательными аргументами включены по умолчанию (completion.optionalArguments); completion.packages добавляет предложения пакетов, completion.snippets переопределяет или скрывает команды. Обычный текст, пути к изображениям, комментарии и код Markdown исключены. Динамические ссылки и некоторые команды TeX имеют ограничения; предложения других расширений могут дублироваться. Инструкция и ограничения (китайский / английский).
• Включение и выключение предпросмотра: Ctrl+Alt+M (Mac: ⌘⌥M). Клавиша Esc закрывает текущий предпросмотр.
• Настройки: Нажмите Silk Math в строке состояния, чтобы изменить размер предпросмотра и выбрать типы файлов. Параметр Другие типы файлов по умолчанию выключен; включите его для распознавания формул LaTeX в обычном тексте, в том числе в файлах без имени. Silk Math → Изменить правила исключения… открывает silkMath.preview.excludeFiles и silkMath.completion.excludeFiles; оба списка по умолчанию пусты ([]). *.tex исключает все файлы TeX, а notes.tex — файлы с этим именем в любой папке. Путь chapters/draft.tex отсчитывается от папки рабочей области; абсолютный путь исключает только указанный файл. Регистр не учитывается; поддерживаются *, ? и ** как отдельный сегмент пути. Настройки silkMath.preview.excludeFileTypes и silkMath.completion.excludeFileTypes по-прежнему принимают расширения (.tex, .md, *.ipynb) или идентификаторы языка (latex, markdown). В меню строки состояния можно отключить или восстановить предпросмотр, автодополнение либо оба для текущего файла; для notebook это действует на весь блокнот. Выбор сохраняется локально в рабочей области. После восстановления продолжают действовать правила исключения, настройки предпросмотра и режим автодополнения; меню показывает правило, которое всё ещё исключает файл. В меню правил всегда есть добавление; выберите правило для изменения или очистите его для удаления. Новые правила сохраняются в настройках пользователя; можно выбрать рабочую область, папку или язык. Silk Math → Все сочетания клавиш… показывает все действия, включая снимок экрана: выберите действие и назначьте клавиши в VS Code. Прежние назначения сохраняются; команда дополнения Silk доступна только в manual.
• Копирование изображения: Отдельная область шириной 26px справа не позволяет кнопке перекрывать формулу, в том числе при прокрутке. Кнопка справа вверху копирует всю формулу как PNG с чёрным текстом на белом фоне, без курсора и обрезки. Всё выполняется в фоне, без дополнительной страницы. Только после успешной записи в буфер обмена значок плавно превращается в галочку и возвращается через 1,6 секунды. Учитывается настройка уменьшения движения. Windows/macOS используют системные API; Linux требует wl-copy (Wayland) или xclip (X11).
• CSS предпросмотра: Откройте Silk Math → Изменить CSS предпросмотра… и сохраните изменения; очистите и сохраните для сброса. Слишком широкие или высокие формулы сохраняют размер шрифта: в плавающем окне доступна прокрутка по обеим осям с ползунками шириной 5px. При открытии или редактировании видна область вокруг курсора формулы; ручная прокрутка сохраняется до следующего изменения или перемещения курсора в исходнике. При любом размере сохраняется выбранная сторона: сверху, снизу или справа (по умолчанию снизу), даже при нехватке места. Выключные формулы уменьшены на 15%, строчные не изменились. Для формул любого размера можно выбрать привязку к курсору, выделению или всей формуле, расположение сверху/снизу/справа, интервалы, смещение и перекрытие. Настраиваются шрифт, границы окна, фон, рамка и тень. По умолчанию: отступы 4px 8px, скругление 6px. Дополнение, подсказки и пояснения ко всем параметрам доступны на китайском и английском. Точные границы зависят от совместимой разметки редактора. Прокрутка, примеры CSS и ограничения (китайский / английский).
• TikZ / pgfplots: Включите Предпросмотр TikZ / pgfplots (silkMath.tikz.enabled, по умолчанию выключен) и установите курсор в окружении tikzpicture. SVG обновляется при редактировании, даже до сохранения файла. При первом использовании загружается движок WebAssembly с проверкой целостности; затем он работает без сети и без установки LaTeX. В комплект входят pgfplots 1.18.3 и поддержка compat=1.18, групповых графиков, библиотек построения графиков и определений макросов TeX. Сложные рисунки могут обрабатываться дольше; возможности не равнозначны полному дистрибутиву TeX. Руководство по TikZ и примеры (на китайском и английском).
• Распознавание снимков экрана и изображений (OCR): Нажмите значок захвата в строке состояния и выделите область экрана мышью. Распознавание начнётся, когда вы отпустите кнопку. В компактном меню можно скопировать, вставить или отредактировать результат. Через Silk Math → Recognize image… (распознать изображение) можно вставить изображение или выбрать файл PNG / JPEG. Модели загружаются при первом использовании и работают локально; изображения не отправляются на сервер.
• Сочетания клавиш OCR: Ctrl+Alt+O (Mac: ⌘⌥O) открывает меню распознавания, где Ctrl+V (Mac: ⌘V) вставляет изображение. В редакторе Ctrl+Alt+V (Mac: ⌘⌥V) сразу запускает распознавание изображения из буфера обмена. Параметр silkMath.ocr.pasteImages включён по умолчанию: обычная вставка изображения в редакторах LaTeX и Markdown тоже запускает OCR. Если редактор не поддерживает API вставки изображений, используйте меню распознавания или сочетание клавиш для буфера обмена.
• Точность OCR: Пустые поля по краям обрезаются, фон приводится к единому виду. При сомнительном результате выполняется одна повторная попытка распознавания. Структура таблиц сохраняется, но результат может быть помечен для проверки. Сложные таблицы, рукописный текст и размытые изображения по-прежнему нужно проверять. Процесс распознавания и ограничения (на китайском).
• Тестовая версия: Добавьте Shift к сочетаниям Ctrl+Alt+M/O/V (Mac: ⌘⌥M/O/V). Тестовая версия использует отдельные настройки silkMathTest.*. Автоматическое распознавание при вставке изображений по умолчанию выключено; его можно включить через silkMathTest.ocr.pasteImages. Если обе версии показывают предпросмотр в одном редакторе, в общем плавающем окне приоритет имеет тестовая версия.

Формулы внутри окружений теорем и proposition просматриваются отдельно; текст и нумерация теорем не верстаются. В длинных документах сохраняется контекст математических разделителей, а буквальный код LaTeX не нарушает границы соседних формул.

Языки

Italiano

Un’estensione per Visual Studio Code che mostra le formule LaTeX mentre scrivi. Apri un file .tex, Markdown, MDX o Quarto, oppure un notebook Jupyter (.ipynb), e posiziona il cursore all’interno di una formula. Accanto compare un’anteprima fluttuante di MathJax, con una sottile linea arancione che indica il punto di inserimento. Non serve eseguire latexmk, generare un PDF o compilare il documento.

Supporta le formule nel testo con $...$ e \(...\), le formule su una riga separata con \[...\], ambienti come equation, align e tabular, e le tabelle GitHub Flavored Markdown. I comandi non definiti appaiono in rosso, mentre il resto della formula continua a essere visualizzato.

Le dichiarazioni dei pacchetti e le dipendenze locali vengono rilevate automaticamente, comprese le macro personalizzate più comuni nei file .sty / .cls e le modifiche non salvate nei file di dipendenze aperti. I comandi per numeri e unità, come \num, \SI e \qty, e le macro personalizzate utilizzabili in modalità testo funzionano anche nelle celle delle tabelle. Macro supportate e limitazioni (in cinese).

Cerca Silk Math Preview nella vista Estensioni o visita la pagina di Visual Studio Marketplace. Richiede VS Code 1.95 o successivo su Windows, macOS o Linux.

• Completamento matematico: Nelle formule: snippet con argomenti, ambienti abbinati, macro personalizzate e chiavi locali di etichette, riferimenti e citazioni, comprese le modifiche non salvate. silkMath.completion.mode offre per linguaggio on (predefinito), off e manual rigoroso, senza modificare l’anteprima. Scegli “Modalità di completamento matematico…” nel menu della barra di stato per impostare la lingua corrente. In manual: Ctrl+Spazio con l’elenco chiuso o Silk Math: Trigger Math Completion; “Scorciatoia del completamento matematico…” cambia i tasti (silkMath.triggerCompletion). Queste scorciatoie Silk e la relativa voce di impostazione sono attive solo in manual. on mantiene i suggerimenti automatici e il normale comportamento dei tasti di VS Code. Versione di test: silkMathTest.*, Ctrl+Alt+Maiusc+Spazio. Le varianti con argomenti facoltativi sono attive per impostazione predefinita (completion.optionalArguments); completion.packages aggiunge suggerimenti dei pacchetti, completion.snippets sostituisce o nasconde comandi. Testo normale, percorsi delle immagini, commenti e codice Markdown sono esclusi. I riferimenti dinamici e alcuni comandi TeX hanno limitazioni; possono comparire duplicati di altre estensioni. Guida e limiti (cinese / inglese).
• Attivare o disattivare l’anteprima: Ctrl+Alt+M (Mac: ⌘⌥M). Premi Esc per chiudere l’anteprima attuale.
• Impostazioni: Fai clic su Silk Math nella barra di stato per regolare la dimensione dell’anteprima e scegliere i tipi di file abilitati. Altri tipi di file è disattivato per impostazione predefinita; attivalo per riconoscere le formule LaTeX anche nel testo semplice, inclusi i file senza nome. Silk Math → Modifica regole di esclusione… apre silkMath.preview.excludeFiles e silkMath.completion.excludeFiles, entrambi vuoti ([]) per impostazione predefinita. *.tex esclude tutti i file TeX; notes.tex, quel nome in qualsiasi cartella. chapters/draft.tex è relativo alla cartella dell’area di lavoro; un percorso assoluto riguarda solo quel file. I criteri ignorano maiuscole e minuscole e supportano *, ? e ** come segmento intero. silkMath.preview.excludeFileTypes e silkMath.completion.excludeFileTypes continuano ad accettare estensioni (.tex, .md, *.ipynb) o ID del linguaggio (latex, markdown). Dal menu della barra di stato puoi escludere o ripristinare l’anteprima, il completamento o entrambi per il file attuale; nei notebook la scelta riguarda l’intero notebook. Le scelte restano locali all’area di lavoro. Dopo il ripristino valgono ancora le regole di esclusione, le impostazioni dell’anteprima e la modalità di completamento; il menu mostra la regola che continua a escludere il file. Il menu delle regole offre sempre l’aggiunta; seleziona una regola per modificarla o svuotala per eliminarla. Le nuove regole vanno nelle impostazioni utente; puoi scegliere anche area di lavoro, cartella o lingua. Silk Math → Tutte le scorciatoie da tastiera… elenca tutte le azioni, inclusa la cattura dello schermo: scegli un’azione e assegna i tasti in VS Code. Le scorciatoie esistenti restano invariate; il comando di completamento Silk è attivo solo in manual.
• Copia immagine: Un’area riservata di 26px a destra impedisce al pulsante di coprire la formula, anche durante lo scorrimento. Il pulsante in alto a destra copia tutta la formula come PNG in nero su sfondo bianco, senza cursore o parti tagliate. Opera in background senza aprire altre pagine. Il segno di spunta animato appare solo dopo la scrittura riuscita negli appunti; l’icona torna dopo 1,6 secondi. Rispetta la preferenza di movimento ridotto. Windows/macOS usano le API di sistema; Linux richiede wl-copy (Wayland) o xclip (X11).
• CSS dell’anteprima: Apri Silk Math → Modifica CSS anteprima… e salva per applicare; svuota e salva per ripristinare. Le formule troppo larghe o alte mantengono la dimensione del carattere in una finestra mobile con scorrimento orizzontale e verticale e cursori delle barre da 5px. All’apertura o durante la modifica viene mostrata la zona del cursore matematico; lo scorrimento manuale resta fino alla modifica successiva o allo spostamento del cursore nel sorgente. Ogni dimensione rispetta il lato scelto (sopra/sotto/a destra, sotto per impostazione predefinita), anche quando manca spazio. Le formule fuori testo sono più piccole del 15%; quelle in linea restano invariate. Per formule di ogni dimensione scegli cursore/selezione/formula come riferimento, posizione sopra/sotto/a destra, distanza, spostamento e sovrapposizione. Regola carattere, limiti della finestra, sfondo, bordo e ombra. Valori predefiniti: spaziatura 4px 8px e raggio 6px. Completamento, aiuto al passaggio del mouse e spiegazioni di tutte le opzioni sono disponibili in cinese e inglese. I limiti precisi dipendono da un layout compatibile dell’editor. Scorrimento, esempi CSS e limiti (cinese / inglese).
• TikZ / pgfplots: Attiva Anteprima TikZ / pgfplots (silkMath.tikz.enabled, disattivata per impostazione predefinita), poi posiziona il cursore in un ambiente tikzpicture. Le modifiche aggiornano l’SVG anche prima di salvare. Al primo utilizzo viene scaricato un motore di rendering WebAssembly di cui viene verificata l’integrità; in seguito funziona offline, senza installare LaTeX. Include pgfplots 1.18.3, compat=1.18, grafici raggruppati, librerie grafiche e definizioni di macro native. Le figure complesse possono richiedere più tempo; le funzionalità non equivalgono a quelle di una distribuzione TeX completa. Guida a TikZ ed esempi (in cinese e inglese).
• Riconoscimento di schermate e immagini (OCR): Fai clic sull’icona di cattura nella barra di stato e trascina per selezionare un’area dello schermo. Il riconoscimento inizia quando rilasci il pulsante del mouse. Un menu compatto permette di copiare, inserire o modificare il risultato. Scegli Silk Math → Recognize image… (riconosci immagine) per incollare un’immagine o selezionare un file PNG / JPEG. I modelli vengono scaricati al primo utilizzo ed eseguiti localmente; le immagini non vengono caricate su server.
• Scorciatoie OCR: Ctrl+Alt+O (Mac: ⌘⌥O) apre il menu di riconoscimento, dove puoi incollare un’immagine con Ctrl+V (Mac: ⌘V). Nell’editor, Ctrl+Alt+V (Mac: ⌘⌥V) riconosce direttamente l’immagine negli appunti. Con silkMath.ocr.pasteImages, attivo per impostazione predefinita, anche il normale incollaggio di un’immagine negli editor LaTeX e Markdown avvia l’OCR. Se l’editor non dispone dell’API per incollare immagini, usa il menu di riconoscimento o la scorciatoia per gli appunti.
• Accuratezza dell’OCR: I margini vuoti vengono ritagliati e lo sfondo uniformato; in caso di risultati dubbi viene eseguito un secondo tentativo di riconoscimento. La struttura delle tabelle viene preservata, ma il risultato può essere segnalato per una verifica. Tabelle complesse, scrittura a mano e immagini sfocate richiedono comunque un controllo. Processo di riconoscimento e limitazioni (in cinese).
• Versione di test: Aggiungi Shift (Maiusc) alle scorciatoie Ctrl+Alt+M/O/V (Mac: ⌘⌥M/O/V). Questa versione usa impostazioni separate sotto silkMathTest.*. Il riconoscimento automatico quando incolli un’immagine è disattivato per impostazione predefinita e può essere attivato con silkMathTest.ocr.pasteImages. Se entrambe le versioni mostrano l’anteprima nello stesso editor, la versione di test ha priorità nella finestra mobile condivisa.

Le formule negli ambienti di teorema o proposition vengono visualizzate singolarmente; il testo e la numerazione del teorema non vengono impaginati. Nei documenti lunghi viene mantenuto il contesto dei delimitatori, e il codice LaTeX letterale non altera i confini delle formule vicine.

Lingue

MIT License · Jasper Zhou · GitHub · LICENSE · Third-party notices