Argdown for Visual Studio Code
Argdown is a simple syntax for analyzing complex argumentation, inspired by Markdown. This extension provides full language support for Argdown in VS Code:
- Live Preview of your argument map
- 2 map layout algorithms (DagreD3 & Viz.js)
- Code completion
- Symbol search, outline and breadcrumb support
- Quick info (hover)
- Folding ranges
- Jump to/peek at references and definitions
- Syntax highlighting
- Linting (Code Diagnostics)
- Export to Html, Dot, JSON, SVG, PNG and PDF
If you want to learn more about Argdown argumentation syntax, read the guide and documentation.
Why the extension was temporarily unpublished
On 2018-11-26 the extension was unpublished on the Marketplace as it was one of the extensions that inadvertantly depended on the open-source library event-stream that was used by hackers to introduce a "backdoor" vulnerability. We are not responsible for this hack, nor have we directly used the event-stream library in our code. Instead it was automatically installed by the VS Code yeoman generator for extension authors. As the hack targeted cryptocurrency software, users of this extension were not affected by this hack, however Microsoft decided to be cautious and unpublish all extensions using the library. Version 1.0.3 updated the event-stream package and no longer contains the insecure dependency. We are sorry for any inconveniences caused by the temporary unaivailability.
Working with the extension
VS Code will only load the extension for Argdown documents.
To tell VS Code that your document is an Argdown document, save your document with the
.ad filename extension (e.g.
Activating the Argdown theme
Standard themes do not highlight Argdown relations and elements. For complete syntax highlighting, please activate the Argdown theme:
- Go to
Code/Preferences/Color Themein the main application menu
Argdown Themefrom the list of available themes
The Argdown theme is the default VS Code light theme, enhanced by some Argdown-specific features, so it will also work with other languages.
We hope that VS Code will add support for language-specific themes in the future, so that the Argdown theme will only be active for Argdown files.