Adblock Syntax for VSCode

Complete adblock filter list support for VSCode

Note: This is a development tool for creating and editing adblock filter lists, not an ad blocker for VSCode.

AdGuard・ uBlock Origin・ AdBlock・ Adblock Plus

Install • Documentation • Report Issue • Contributing

• 🎨 Syntax highlighting — Full support for AdGuard, uBlock Origin, and Adblock Plus filter syntax
• 🔍 Real-time linting — Powered by AGLint with instant validation and error detection
• 🛠️ Auto-fixing — Automatically fix issues with AGLint's suggestions and quick fixes
• 🌐 Multi-platform validation — Platform-specific compatibility warnings and syntax checks
• 🐙 GitHub integration — Syntax highlighting on GitHub via Linguist
• ⚙️ Flexible configuration — VSCode settings and AGLint config file (.aglintrc) support
• 🚀 Auto-discovery — Automatically finds AGLint in your workspace (local or global)

1. Open VSCode
2. Press Ctrl+P / Cmd+P
3. Type: ext install adguard.adblock
4. Press Enter

VSCode Marketplace:

1. Open VSCode Marketplace
2. Click Install
3. VSCode will open automatically

Open VSX (for VSCodium, etc.):

1. Open Open VSX Registry
2. Click Download
3. Install the .vsix file manually

1. Open any .txt file with adblock rules
2. Add a filter rule: example.org##.banner
3. You should see syntax highlighting

Note: AGLint linting requires AGLint to be installed in your workspace or globally. See AGLint Configuration for setup details.

💡 Tip: Control AGLint logging via VSCode's built-in log level: Command Palette → Developer: Set Log Level → AGLint

AGLint requires a configuration file to enable linting. The extension will automatically detect AGLint in your workspace.

Run in your project root:

npx aglint --init

This creates an interactive wizard to generate a configuration file.

Supported file names (YAML recommended):

• .aglintrc.yaml / .aglintrc.yml (recommended)
• .aglintrc.json / .aglintrc
• aglint.config.json / aglint.config.yaml

# .aglintrc.yaml root: true extends: - aglint:recommended

• aglint:recommended — Recommended rules for most projects
• aglint:all — All available rules (strict)

For detailed configuration options, rule customization, and cascading configs, see the AGLint documentation.

GitHub uses this extension's grammar file via Linguist for syntax highlighting.

Your filter lists will be automatically highlighted on GitHub if they start with an agent comment like [Adblock Plus 2.0] or [AdGuard].

Contributions are welcome! Please read our Contributing Guide for details on how to get started.

This project is licensed under the MIT License - see the LICENSE file for details.

• AdGuard Filter Syntax
• uBlock Origin Static Filters
• Adblock Plus Filter Guide

• AdGuard Scriptlets
• uBlock Origin Scriptlets
• Adblock Plus Snippets

• MDN CSS Selectors
• AdGuard Extended CSS
• uBlock Origin Procedural Filters
• Adblock Plus Extended CSS

• AGLint - Adblock filter linter
• Compatibility Tables - Cross-platform feature support