# highlightjs-esql

**Repository Path**: mirrors_elastic/highlightjs-esql

## Basic Information

- **Project Name**: highlightjs-esql
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-16
- **Last Updated**: 2025-09-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ES|QL syntax grammar for [highlight.js](https://highlightjs.org/)

This package contains the ES|QL grammar for Highlight.js.

![ES|QL sample highlighted query](https://github.com/user-attachments/assets/1331f854-2615-45e3-9a92-f90a230d95b7)

Usage:

```javascript
const hljs = require('highlight.js');
const esql = require('@elastic/highlightjs-esql');

hljs.registerLanguage('esql', esql);
```


## Contributing

First clone the main Highlight.js repository:

```
git clone https://github.com/highlightjs/highlight.js.git
```

Then clone this repo into the `extra/` directory:

```
cd extra
git clone https://github.com/elastic/highlightjs-esql.git
cd ..
npm i
```

To test changes visually using "developer tool", build ES|QL grammar only:

```
node tools/build.js -n esql
```

Open `tools/developer.html` to see your changes in action.

Run only ES|QL language tests:

```
ONLY_EXTRA=true npm run build-browser
```

Run all tests:

```
npm run test
```




## Releasing

Run build script:

```
npm i
node ./tools/build.js -t node
```

Run CDN build:

```
node ./tools/build.js -t cdn
```

Publish with `release-it` tool:

```
npx release-it
```


## License

MIT