Skip to content

hall/draw

Repository files navigation

Draw, for the VSCode family

Open VSX Version Visual Studio Marketplace Version

Draw an SVG image with a mouse or pen.

screenshot

NOTE: This is an alpha project; please open an issue for any bugs, questions, or ideas!

Usage

Open a file (in a supported format) and run Draw: Edit Current Line by either

  • right clicking on the line or
  • opening the command palette (F1 or Ctrl-Shift-P) and type draw edit

The currently supported formats are

  • markdown
  • asciidoc
  • restructuredtext

Keybindings

Consider binding the main command (perhaps to a stylus, if available). For example, the tail button on my stylus sends the Super + Escape key sequence:

{
    "key": "meta+Escape",
    "command": "draw.editCurrentLine"
}

NOTE: you may have to disable, or rebind, conflicting keys in your OS settings.

Settings

The following settings are available (prefixed with draw).

setting description default example
directory where to save files "" ${workSpaceFolder}/assets
buttons add custom buttons to the toolbar [] see below

directory

To save contents inline, set draw.directory to null.

The following variables are currently supported:

  • workspaceFolder

custom buttons

To add custom buttons to the toolbar, add an entry to the draw.buttons array in settings.json; for example,

{
    "draw.buttons": [
        {
            "icon": "beer",
            "title": "pour another",
            "function": "console.log('hooray!')"
        }
    ]
}

search the Font Awesome set for an icon name

color scheme

The preset color selections are defined by VSCode's chart colors and so can be changed in settings.json.

Handwritten Text Recognition

The following services are available to convert hand-written formulas to LaTeX equations.

myscript

free for 2000 requests/month

  • create an account
  • generate application and HMAC tokens
  • run Draw: Configure HTR Provider and select myscript

mathpix

free for 1000 requests/month but charge a one-time, non-refundable, setup fee of $20

This integration also supports image drag and paste.

  • create an account
  • create an org, pay the setup fee, and create an API key
  • run Draw: Configure HTR Provider and select mathpix

License

This project was forked from zhaouv/vscode-markdown-draw and licensed under the Apache-2.0 License.