feat: add dual CommonJS, ESM, and Deno support

Author: zuchka

.github/workflows/default.yaml

@@ -2,26 +2,91 @@ name: Run tests
 
 on:
   push:
-    branches: [ main ]
+    branches: [main]
   pull_request:
-    branches: [ main ]
+    branches: [main]
+
+permissions:
+  contents: read
 
 jobs:
-  build:
+  node:
+    name: Node ${{ matrix.node-version }}
     runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        node-version: [18.x, 20.x, 22.x, 24.x, 26.x]
+
+    steps:
+      - uses: actions/checkout@v7
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v7
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: npm
+      - run: npm ci
+      - run: npm test
+      - run: npm run test:modules
+      - run: npm run test:package
+
+  types:
+    name: TypeScript package contract
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-node@v7
+        with:
+          node-version: 24.x
+          cache: npm
+      - run: npm ci
+      - run: npm run test:types
 
+  compatibility:
+    name: Published-package compatibility
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-node@v7
+        with:
+          node-version: 24.x
+          cache: npm
+      - run: npm ci
+      - run: npm run test:differential
+      - run: npm run test:bundlers
+
+  package-platform:
+    name: Package smoke (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
     strategy:
+      fail-fast: false
       matrix:
-        node-version: [18.x, 20.x, 22.x]
-        # See supported Node.js release schedule at https://nodejs.org/en/about/releases/
+        os: [ubuntu-latest, macos-latest, windows-latest]
+
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-node@v7
+        with:
+          node-version: 24.x
+          cache: npm
+      - run: npm ci
+      - run: npm run test:package
+
+  deno:
+    name: Deno 2.x
+    runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v3
-    - name: Use Node.js ${{ matrix.node-version }}
-      uses: actions/setup-node@v3
-      with:
-        node-version: ${{ matrix.node-version }}
-        cache: 'npm'
-    - run: npm ci
-    - run: npm run build --if-present
-    - run: npm test
+      - uses: actions/checkout@v7
+      - uses: actions/setup-node@v7
+        with:
+          node-version: 24.x
+          cache: npm
+      - uses: denoland/setup-deno@v2
+        with:
+          deno-version: v2.x
+      - run: npm ci
+      - run: npm run test:deno
+      - run: npm run test:deno:package

CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.7.0] - Unreleased
+
+### Added
+
+- Added a native ES module entry point while preserving the existing CommonJS API.
+- Added Deno 2.x support through the npm package.
+- Added module-specific TypeScript declarations and package-level compatibility tests.
+
+### Changed
+
+- Added conditional package exports for CommonJS, ES modules, and their matching type declarations.
+
+ESM and Deno support was originally proposed in [#116](https://github.com/zuchka/remove-markdown/pull/116) by [@tukkek](https://github.com/tukkek).
+
 ## [0.6.3] - 2026-01-14
 
 ### Added

README.md

@@ -3,25 +3,48 @@
 [![GitHub Actions Build Status](https://github.com/zuchka/remove-markdown/actions/workflows/default.yaml/badge.svg)](https://github.com/zuchka/remove-markdown/actions/workflows/default.yaml)
 
 ## What is it?
-**remove-markdown** is a node.js module that will remove (strip) Markdown formatting from text.
+**remove-markdown** is a JavaScript module that removes (strips) Markdown formatting from text. It supports CommonJS and ES modules in Node.js, plus Deno through npm compatibility.
 *Markdown formatting* means pretty much anything that doesn’t look like regular text, like square brackets, asterisks etc.
 
 ## When do I need it?
 The typical use case is to display an excerpt from some Markdown text, without any of the actual Markdown syntax - for example in a list of posts.
 
 ## Installation
 
-```
+```sh
 npm install remove-markdown
 ```
 
 ## Usage
+
+### CommonJS
+
 ```js
 const removeMd = require('remove-markdown');
 const markdown = '# This is a heading\n\nThis is a paragraph with [a link](http://www.disney.com/) in it.';
 const plainText = removeMd(markdown); // plainText is now 'This is a heading\n\nThis is a paragraph with a link in it.'
 ```
 
+### Node.js ES modules
+
+```js
+import removeMd from 'remove-markdown';
+
+const markdown = '# This is a heading\n\nThis is a paragraph with [a link](http://www.disney.com/) in it.';
+const plainText = removeMd(markdown);
+```
+
+### Deno
+
+```js
+import removeMd from 'npm:remove-markdown@^0.7.0';
+
+const markdown = '# This is a heading\n\nThis is a paragraph with [a link](http://www.disney.com/) in it.';
+const plainText = removeMd(markdown);
+```
+
+Deno support is provided through the npm package; there is no separate JSR package. The package exposes one callable default export in every runtime. Named exports and direct imports from raw GitHub URLs are not supported.
+
 You can also supply an options object to the function. Currently, the following options are supported:
 
 ```js

index.d.mts

@@ -0,0 +1,13 @@
+declare function removeMd(md: string, options?: {
+  stripListLeaders?: boolean;
+  listUnicodeChar?: string;
+  gfm?: boolean;
+  useImgAltText?: boolean;
+  abbr?: boolean;
+  replaceLinksWithURL?: boolean;
+  separateLinksAndTexts?: string;
+  htmlTagsToSkip?: string[];
+  throwError?: boolean;
+}): string;
+
+export default removeMd;

index.mjs

@@ -0,0 +1,3 @@
+import removeMarkdown from './index.js';
+
+export default removeMarkdown;