markdown-it-adv-table 0.2.1 → 0.2.3

package/README.md

@@ -61,9 +61,7 @@ const html = md.render("text...");
 </tr>
 </table>
 
-## Usage
-
-Use fenced code block for the table data.
+## Example
 
 ``````
 ```table cols=4 header-rows=2 header-cols=1
@@ -127,7 +125,9 @@ c3| Q1 Sales
 
 ## Documentation
 
-The table is expressed in a fenced code block. 
+The table is expressed in a fenced code block. The [info-string](https://spec.commonmark.org/0.31.2/#info-string) is parsed as [TableSpec](#tablespec), which defines the properties of the table.
+
+Then, the cells are defined from left-top to right-bottom. 
 
 - A line that starts with `|` starts a new cell.
 - The cell content is parsed as Markdown.
@@ -136,9 +136,7 @@ The table is expressed in a fenced code block.
 A cell marker can include directives that control the cell’s properties.
 
 
-### TableSpec (Table Definition)
-
-The [info-string](https://spec.commonmark.org/0.31.2/#info-string) of the fenced code block is parsed as TableSpec.
+<h3 id="tablespec">TableSpec (Table Definition)</h3>
 
 <table>
 <tr>
@@ -159,12 +157,12 @@ cols="1,1,2"     // 3 columns, 1:1:2 ratio</pre>
 <tr>
     <td>header-cols</td>
     <td>number</td>
-  <td>Number of header columns (rendered as &lt;th&gt;)</td>
+  <td>Number of header columns (rendered with &lt;th&gt;)</td>
 </tr>
 <tr>
     <td>header-rows</td>
     <td>number</td>
-  <td>Number of header rows (rendered as &lt;thead&gt; with &lt;th&gt;)</td>
+  <td>Number of header rows (rendered with &lt;thead&gt; and &lt;th&gt;)</td>
 </tr>
 <tr>
     <td>class</td>
@@ -180,7 +178,7 @@ cols="1,1,2"     // 3 columns, 1:1:2 ratio</pre>
     <td>format</td>
     <td>string</td>
     <td>
-        <p>Use alternative table syntax. </p>
+        <p>Use alternative table syntax (advTable only). </p>
         <ul>
             <li><code>csv</code> : parse text as csv</li>
             <li><code>tsv</code> : parse text as tsv</li>
@@ -191,11 +189,7 @@ cols="1,1,2"     // 3 columns, 1:1:2 ratio</pre>
 
 <h3 id="colspec">ColSpec (Column Definition)</h3>
 
-<code>ColSpec</code> is a comma-separated set-of-directives to control the column's properties.
-
-    "1,1,1"            3 columns, 1:1:1 ratio
-    "30%,15,30,60"     4 columns, 3:1:2:4 ratio
-    "<100px,,>25%"     3 columns, 100px-auto-25% with alignment directives
+<code>ColSpec</code> is a comma-separated directives to set column's properties.
 
 <table>
 <tr>
@@ -215,11 +209,7 @@ cols="1,1,2"     // 3 columns, 1:1:2 ratio</pre>
 </tr>
 <tr>
     <td>&lt;<br>^<br>&gt;</td>
-    <td>
-    Left-aligned<br>
-    Center-aligned<br>
-    Right-aligned<br>
-    </td>
+    <td>Left-aligned<br>Center-aligned<br>Right-aligned</td>
 </tr>
 </table>
 
@@ -252,6 +242,7 @@ cols="1,1,2"     // 3 columns, 1:1:2 ratio</pre>
 
 
 
+
 ## More Examples
 
 
@@ -264,7 +255,7 @@ cols="1,1,2"     // 3 columns, 1:1:2 ratio</pre>
 
 r3| Fruits
 | Apple
->| $1.00 
+^| $1.00 
 | A smooth, round fruit with shiny red skin.
 
 | Banana

package/RELEASE.md

@@ -0,0 +1,37 @@
+
+# Release Log
+
+## 0.2.3 (2026-02-10)
+
+- Fix: colspec with 1 column not properly parsed
+- Fix: alignment directive in tableSpec was unused
+
+## 0.2.2 (2026-02-08)
+
+- Fix: output was sometimes wrong when table attrs were wrapped in quotes
+- Fix: output was wrong when all columns were header without body cells
+
+## 0.2.1 (2026-02-08)
+
+- Fix: width field not properly parsed
+
+## 0.2.0 (2026-02-07)
+
+- New: Support setting table and column width
+- New: Support Quoted classnames with space delimitors
+- Fix: Prevent plugin crashing on invalid syntax
+- Change: Removed support to change language names, except advTable plugin.
+
+## 0.1.2 b2 (2025-05-20)
+
+- Updated project structure. No code change.
+
+## 0.1.1 b1 (2025-05-19)
+
+- Fix: thead opened multiple times
+- Fix: empty classname was being set
+- Change: changed some option names
+
+## 0.1.0 b0 (2025-05-19)
+
+- Initial Release

package/lib/table-builder.js

@@ -13,7 +13,7 @@ export class TableBuilder {
         return new TableBuilder(new state.md.block.State("", state.md, state.env, []), tableSpec);
     }
     get useColgroup() {
-        return this.tableSpec.attr.cols?.startsWith("\"");
+        return this.tableSpec.colspecs.finemode;
     }
     get useTHead() {
         return this.tableSpec.headerRows > 0;
@@ -64,9 +64,6 @@ export class TableBuilder {
             if (this.useTHead && row === 0) {
                 this.startTHead();
             }
-            else if (this.useTBody && row === this.tableSpec.headerRows) {
-                this.startTBody();
-            }
             this.startRow();
         }
         const token = this.state.push(`${tx}_open`, tx, 1);
@@ -76,6 +73,9 @@ export class TableBuilder {
         if (cell && cell.attr.colspan !== undefined) {
             token.attrSet("colspan", cell.colspan.toString());
         }
+        if (cell && this.tableSpec.colSpec(col).align !== undefined) {
+            token.attrSet("style", `text-align: ${this.tableSpec.colSpec(col).align}`);
+        }
         if (cell && cell.attr.align !== undefined) {
             token.attrSet("style", `text-align: ${cell.attr.align}`);
         }
@@ -85,6 +85,7 @@ export class TableBuilder {
             this.endRow();
             if (this.useTHead && row == this.tableSpec.headerRows - 1) {
                 this.endTHead();
+                this.startTBody();
             }
         }
     }

package/lib/table.d.ts

@@ -1,5 +1,6 @@
 type HAlign = "left" | "center" | "right";
-type TableAttrKeys = "cols" | "class" | "header-rows" | "header-cols" | "format";
+declare const tableAttrKeys: readonly ["cols", "class", "header-rows", "header-cols", "width", "format"];
+type TableAttrKeys = typeof tableAttrKeys[number];
 export type TableAttr = {
     [key in TableAttrKeys]?: string;
 } & {
@@ -30,13 +31,15 @@ export declare class TableSpec {
     readonly colspecs: ColSpecs;
     constructor(attr: TableAttr);
     get numCols(): number;
+    colSpec(col: number): ColumnAttr;
     static parseClass(classnames: string): string[];
     static parseInfoString(info: string): TableAttr;
-    static awareKeys(): TableAttrKeys[];
+    static awareKeys(): readonly TableAttrKeys[];
 }
 export declare class ColSpecs {
     readonly numCols: number;
     readonly specs: readonly ColumnAttr[];
+    readonly finemode: boolean;
     constructor(colspec: string);
     colSpec(col: number): ColumnAttr;
     colWidth(col: number): ColWidth;

package/lib/table.js

@@ -10,6 +10,14 @@ const cssUnits = [
     "dvw", "dvh", "dvi", "dvb", "dvmin", "dvmax",
     "cqw", "cqh", "cqi", "cqb", "cqmin", "cqmax"
 ];
+const tableAttrKeys = [
+    "cols",
+    "class",
+    "header-rows",
+    "header-cols",
+    "width",
+    "format"
+];
 export class ColWidth {
     text;
     constructor(text) {
@@ -54,6 +62,9 @@ export class TableSpec {
     get numCols() {
         return this.colspecs.numCols;
     }
+    colSpec(col) {
+        return this.colspecs.colSpec(col);
+    }
     static parseClass(classnames) {
         return unwrapLiteral(classnames, "\"")
             .split(/[\s,]/)
@@ -92,7 +103,7 @@ export class TableSpec {
                 const key = consume();
                 consume("=");
                 const value = consume();
-                result[key] = value;
+                result[key] = unwrapLiteral(value, "\"");
             }
             else {
                 consume();
@@ -109,33 +120,30 @@ export class TableSpec {
         }
     }
     static awareKeys() {
-        const k = {
-            cols: "",
-            align: "",
-            "header-cols": "",
-            "header-rows": "",
-            class: "",
-            width: "",
-            format: ""
-        };
-        return Object.keys(k);
+        return tableAttrKeys;
     }
 }
 export class ColSpecs {
     numCols;
     specs;
+    finemode = false;
     constructor(colspec) {
         if (colspec.startsWith("\"") || colspec.includes(",")) {
             const specs = unwrapLiteral(colspec, "\"").split(",");
             this.numCols = Math.max(1, specs.length);
             this.specs = specs.map(ColSpecs.parseColSpec);
+            this.finemode = true;
         }
-        else if (/^\d+/.test(colspec)) {
+        else if (/^\d+$/.test(colspec)) {
             this.numCols = Math.max(1, parseInt(colspec, 10));
             this.specs = Array(this.numCols).fill({});
         }
+        else if (/^\d+/.test(colspec)) {
+            this.numCols = 1;
+            this.specs = [ColSpecs.parseColSpec(colspec)];
+        }
         else {
-            this.numCols = 0;
+            this.numCols = 1;
             this.specs = Array(this.numCols).fill({});
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "markdown-it-adv-table",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Markdown syntax extension for better table support",
   "keywords": [
     "markdown",
@@ -23,7 +23,8 @@
   "types": "lib/index.d.ts",
   "files": [
     "lib/**/*.js",
-    "lib/**/*.d.ts"
+    "lib/**/*.d.ts",
+    "RELEASE.md"
   ],
   "scripts": {
     "build": "tsc",
@@ -34,9 +35,9 @@
     "lint:fix": "eslint src --fix"
   },
   "devDependencies": {
-    "@cobapen/eslint-config": "^0.5.0",
+    "@cobapen/eslint-config": "^0.5.1",
     "@types/markdown-it": "^14.1.2",
-    "@types/node": "^25.2.1",
+    "@types/node": "^25.2.2",
     "@vitest/coverage-v8": "^4.0.18",
     "eslint": "^9.39.2",
     "markdown-it": "^14.1.0",