diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
new file mode 100644
index 00000000..1d1c45fd
--- /dev/null
+++ b/.github/workflows/release.yml
@@ -0,0 +1,111 @@
+name: release
+
+on:
+  workflow_dispatch:
+    inputs:
+      publishPreRelease:
+        description: 'Publish a pre-release ?'
+        required: true
+        type: choice
+        options:
+          - 'true'
+          - 'false'
+        default: 'false'
+      publishToMarketPlace:
+        description: 'Publish to VS Code Marketplace ?'
+        required: true
+        type: choice
+        options:
+          - 'true'
+          - 'false'
+        default: 'true'
+      publishToOVSX:
+        description: 'Publish to OpenVSX Registry ?'
+        required: true
+        type: choice
+        options:
+          - 'true'
+          - 'false'
+        default: 'true'
+
+jobs:
+  packaging-job:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout vscode-yaml
+        uses: actions/checkout@v4
+      - name: Use Node.js
+        uses: actions/setup-node@v4
+        with:
+          path: release
+          node-version: 20
+      - name: Install dependencies
+        run: |
+          npm install -g typescript "yarn" "@vscode/vsce" "ovsx"
+          npm install
+          echo "EXT_VERSION=$(cat package.json | jq -r .version)" >> $GITHUB_ENV
+      - name: Build vscode-yaml
+        uses: coactions/setup-xvfb@b6b4fcfb9f5a895edadc3bc76318fae0ac17c8b3 #v1.0.1
+        with:
+          run: |
+            yarn install
+            yarn run build
+            yarn run check-dependencies
+      - name: Run Unit Tests
+        uses: coactions/setup-xvfb@b6b4fcfb9f5a895edadc3bc76318fae0ac17c8b3 #v1.0.1
+        with:
+          run: yarn test --silent
+      - name: Package
+        run: |
+          node ./out/build/update-readme.js
+          vsce package --target ${target} -o yaml-${{ env.EXT_VERSION }}-${GITHUB_RUN_NUMBER}-${target}.vsix
+          sha256sum *-${target}.vsix > yaml-${{ env.EXT_VERSION }}-${GITHUB_RUN_NUMBER}-${target}.vsix.sha256
+          ls -lash *.vsix *.sha256
+      - name: Upload VSIX Artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: vscode-yaml
+          path: yaml-${{ env.EXT_VERSION }}-${{github.run_number}}*.vsix
+          if-no-files-found: error
+      - name: Publish to GH Release Tab
+        if: ${{ inputs.publishToMarketPlace == 'true' && inputs.publishToOVSX == 'true' }}
+        uses: "marvinpinto/action-automatic-releases@919008cf3f741b179569b7a6fb4d8860689ab7f0"
+        with:
+          repo_token: "${{ secrets.GITHUB_TOKEN }}"
+          automatic_release_tag: "${{ env.EXT_VERSION }}"
+          draft: true
+          files: |
+            yaml-${{ env.EXT_VERSION }}-${{github.run_number}}*.vsix
+            yaml-${{ env.EXT_VERSION }}-${{github.run_number}}*.sha256
+
+  release-job:
+    if: ${{ inputs.publishToMarketPlace == 'true' || inputs.publishToOVSX == 'true' }}
+    environment: ${{ (inputs.publishToMarketPlace == 'true' || inputs.publishToOVSX == 'true') && 'release' || 'pre-release' }}
+    runs-on: ubuntu-latest
+    needs: packaging-job
+    steps:
+    - name: Checkout vscode-yaml
+      uses: actions/checkout@v4
+    - name: Use Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: 20
+    - name: Install dependencies
+      run: |
+        npm install -g typescript "yarn" "@vscode/vsce" "ovsx"
+        npm install
+        echo "EXT_VERSION=$(cat package.json | jq -r .version)" >> $GITHUB_ENV
+    - name: Download VSIX Artifacts
+      uses: actions/download-artifact@v4
+    - name: Publish to VS Code Marketplace
+      if: ${{ github.event_name == 'schedule' || inputs.publishToMarketPlace == 'true' || inputs.publishPreRelease == 'true' }}
+      run: |
+        for platform in darwin-x64 darwin-arm64 linux-x64 win32-x64 win32-arm64; do
+          vsce publish -p ${{ secrets.VSCODE_MARKETPLACE_TOKEN }} --packagePath vscode-yaml/yaml-${{ env.EXT_VERSION }}-${GITHUB_RUN_NUMBER}-${platform}.vsix
+        done
+    - name: Publish to OpenVSX Registry
+      if: ${{ github.event_name == 'schedule' || inputs.publishToOVSX == 'true' || inputs.publishPreRelease == 'true' }}
+      run: |
+        for platform in darwin-x64 darwin-arm64 linux-x64 win32-x64 win32-arm64; do
+          ovsx publish -p ${{ secrets.OVSX_MARKETPLACE_TOKEN }} --packagePath vscode-yaml/yaml-${{ env.EXT_VERSION }}-${GITHUB_RUN_NUMBER}-${platform}.vsix
+        done
diff --git a/build/update-readme.ts b/build/update-readme.ts
new file mode 100644
index 00000000..a216b53e
--- /dev/null
+++ b/build/update-readme.ts
@@ -0,0 +1,14 @@
+/*-----------------------------------------------------------------------------------------------
+ *  Copyright (c) Red Hat, Inc. All rights reserved.
+ *  Licensed under the MIT License. See LICENSE file in the project root for license information.
+ *-----------------------------------------------------------------------------------------------*/
+
+import { readFileSync, writeFileSync } from 'fs-extra';
+
+const readme = readFileSync('./README.md');
+
+const lines = `${readme}`.split('\n');
+
+const index = lines.findIndex((line) => line.includes('## Overview'));
+lines.splice(0, index + 1);
+writeFileSync('./README.md', lines.join('\n'));