confluence-md-sync 0.7.0 → 0.8.1

package/README.md

@@ -318,6 +318,31 @@ const rows = readCsv(decodeText(await page.getAttachment('data.csv')));
 
 ## Macros
 
+### Native Markdown syntax (0.8.0+)
+
+Popular macros are written (and exported back) as plain Markdown — no comment
+markers, no raw XHTML. Round-trip is verified canonically per macro; anything
+that doesn't fit falls back to markers/fenced blocks automatically.
+
+| Macro | Markdown |
+| --- | --- |
+| `info` / `note` / `warning` / `tip` | `> [!INFO] Title?` + quoted body (GitHub-style admonition) |
+| `details` (Page Properties) | `::: properties [id=…] [hidden=true]` + md-table + `:::` — complex Confluence tables are normalized to GFM on export (styling dropped, cell text verified; `stats.normalized`) |
+| `expand` | `::: expand Title` + body + `:::` |
+| `panel` | `::: panel title=… borderColor=…` + body + `:::` |
+| `toc` | `{{toc}}` / `{{toc:maxLevel=3}}` |
+| `children` | `{{children}}` / `{{children:depth=2}}` |
+| `jira` | `{{jira:KEY-1}}` / `{{jira:jql=project = X\|maximumIssues=20}}` |
+| `status` | `{{status:Текст\|colour=Green\|subtle=true}}` |
+| `anchor` | `{{anchor:name}}` |
+| `detailssummary` (Page Properties Report) | `{{properties-report:cql=…\|firstcolumn=…}}` |
+
+Inside fenced code blocks the syntax is left untouched. The machine-readable
+list is exported as `nativeMacroList()`; the md→markers pass is
+`nativeToMarkers()` (runs automatically inside `renderToStorage`).
+
+### Marker builders
+
 Builders return `Markdown` with comment markers; markers become
 `<ac:structured-macro>` after rendering (nested macros resolve inner-first):
 

package/dist/export/to-markdown.d.ts

@@ -61,6 +61,10 @@ export interface StorageToMarkdownResult {
         rawHtml: number;
         /** readable-режим: сколько узлов конвертировано с потерей оформления. */
         lossy: number;
+        /** Макросы, выраженные нативным md-синтаксисом (панели, ::: …, {{…}}). */
+        native: number;
+        /** details, чья таблица нормализована в GFM (оформление потеряно, текст сверен). */
+        normalized: number;
     };
 }
 /** Конвертирует storage-фрагмент страницы в Markdown. */

package/dist/export/to-markdown.js

@@ -79,7 +79,7 @@ class Converter {
     registry;
     images = new Set();
     files = new Set();
-    stats = { markers: 0, fenced: 0, rawHtml: 0, lossy: 0 };
+    stats = { markers: 0, fenced: 0, rawHtml: 0, lossy: 0, native: 0, normalized: 0 };
     readable;
     localFiles;
     tablesAsRecords;
@@ -290,8 +290,160 @@ class Converter {
         return escapeMdText(textContent(el.children), {}, this.readable).trim();
     }
     // ── Макросы ──────────────────────────────────────────────────────────
+    // ── Нативный md-синтаксис (native.ts): панели, ::: properties/expand/panel,
+    // {{toc}}/{{children}}/{{jira}}/{{status}}/{{anchor}}/{{properties-report}}.
+    // Каждый кандидат проверяется рендером и канонической сверкой (как маркеры).
+    static NATIVE_ADMONITION_TAG = {
+        info: 'INFO', note: 'NOTE', warning: 'WARNING', tip: 'TIP',
+    };
+    static NATIVE_PLACEHOLDER_NAME = {
+        toc: 'toc', children: 'children', jira: 'jira', status: 'status',
+        anchor: 'anchor', detailssummary: 'properties-report',
+    };
+    tryNativeMd(el, name) {
+        if (this.readable)
+            return null; // readable-путь остаётся прежним
+        const parts = this.macroParts(el);
+        if (parts === null)
+            return null;
+        const { params, richBody, plainBody } = parts;
+        if (plainBody !== null)
+            return null;
+        const pmap = new Map(params.map((p) => [p.name, p.value]));
+        const oneline = (v) => v !== undefined && !/[\n|{}]/.test(v) && !v.includes('}}');
+        let candidate = null;
+        const tag = Converter.NATIVE_ADMONITION_TAG[name];
+        if (tag && richBody !== null) {
+            // Панель: параметры — только title.
+            if (![...pmap.keys()].every((k) => k === 'title'))
+                return null;
+            const title = pmap.get('title');
+            if (title !== undefined && (!oneline(title) || /\[|\]/.test(title)))
+                return null;
+            const bodyMd = this.bodyMd(richBody);
+            if (bodyMd === null || bodyMd.trim() === '')
+                return null;
+            const quoted = bodyMd.split('\n').map((l) => (l === '' ? '>' : `> ${l}`)).join('\n');
+            candidate = `> [!${tag}]${title ? ' ' + title : ''}\n${quoted}`;
+        }
+        else if (name === 'details' && richBody !== null) {
+            // «Свойства страницы»: параметры id/hidden, тело — простая md-таблица.
+            if (![...pmap.keys()].every((k) => k === 'id' || k === 'hidden'))
+                return null;
+            const bodyEls = elements(richBody.children);
+            const nonWs = richBody.children.filter((n) => !(n.kind === 'text' && /^[ \t\r\n]*$/.test(n.raw)));
+            if (bodyEls.length !== 1 || nonWs.length !== 1 || bodyEls[0].name !== 'table')
+                return null;
+            const dp = [...pmap.entries()].map(([k, v]) => (oneline(v) && !/["\s]/.test(v) ? ` ${k}=${v}` : null));
+            if (dp.some((x) => x === null))
+                return null;
+            let tableMd = null;
+            try {
+                tableMd = this.tableToMd(bodyEls[0]);
+            }
+            catch (e) {
+                if (!(e instanceof Unrepresentable))
+                    throw e;
+            }
+            if (tableMd !== null) {
+                candidate = `::: properties${dp.join('')}\n${tableMd}\n:::`;
+            }
+            else {
+                // «Свойства страницы» обязаны жить md-таблицей: сложную таблицу
+                // нормализуем в GFM (оформление теряется, текст сверяется рендером).
+                const norm = this.propertiesGridMd(bodyEls[0]);
+                if (norm === null)
+                    return null;
+                const cand = `::: properties${dp.join('')}\n${norm.md}\n:::`;
+                if (!this.verifyNormalizedDetails(cand, norm.rows))
+                    return null;
+                this.stats.normalized++;
+                return cand; // канонической эквивалентности нет по построению — верифицирован текст
+            }
+        }
+        else if (name === 'expand' && richBody !== null) {
+            if (![...pmap.keys()].every((k) => k === 'title'))
+                return null;
+            const title = pmap.get('title');
+            if (title !== undefined && (!oneline(title) || /=|"/.test(title)))
+                return null;
+            const bodyMd = this.bodyMd(richBody);
+            if (bodyMd === null)
+                return null;
+            candidate = `::: expand${title ? ' ' + title : ''}\n${bodyMd}\n:::`;
+        }
+        else if (Converter.NATIVE_PLACEHOLDER_NAME[name] && richBody === null) {
+            // Bodyless-плейсхолдеры. Части значений с | или }} не выразить — маркер.
+            const ph = Converter.NATIVE_PLACEHOLDER_NAME[name];
+            const attrs = [];
+            let head = '';
+            for (const p of params) {
+                if (!oneline(p.value) || p.value.includes('|'))
+                    return null;
+                if (name === 'jira' && p.name === 'key' && head === '') {
+                    head = p.value;
+                    continue;
+                }
+                if (name === 'status' && p.name === 'title' && head === '') {
+                    head = p.value;
+                    continue;
+                }
+                if (name === 'anchor' && (p.name === 'name' || p.name === '') && head === '') {
+                    head = p.value;
+                    continue;
+                }
+                const attrName = name === 'jira' && p.name === 'jqlQuery' ? 'jql' : p.name;
+                if (!/^[A-Za-z-]+$/.test(attrName))
+                    return null;
+                attrs.push(`${attrName}=${p.value}`);
+            }
+            const inner = [head, ...attrs].filter((s, i) => s !== '' || i > 0).join('|');
+            candidate = inner === '' ? `{{${ph}}}` : `{{${ph}:${inner}}}`;
+        }
+        if (candidate === null)
+            return null;
+        return this.verifyMacroMarker(el, candidate) ? candidate : null;
+    }
+    /** Разбирает macro-элемент на параметры и тела; null — посторонние дети. */
+    macroParts(el) {
+        const params = [];
+        let richBody = null;
+        let plainBody = null;
+        for (const child of elements(el.children)) {
+            if (child.name === 'ac:parameter') {
+                const pname = getAttr(child, 'ac:name') ?? '';
+                params.push({ name: pname, value: decodeEntities(textContent(child.children)) });
+            }
+            else if (child.name === 'ac:rich-text-body')
+                richBody = child;
+            else if (child.name === 'ac:plain-text-body')
+                plainBody = child;
+            else
+                return null;
+        }
+        return { params, richBody, plainBody };
+    }
+    /** Тело макроса → md; null, если не легло без потерь. */
+    bodyMd(richBody) {
+        const before = { images: new Set(this.images), files: new Set(this.files) };
+        try {
+            return this.blocksToMd(richBody.children).trimEnd();
+        }
+        catch (e) {
+            if (!(e instanceof Unrepresentable))
+                throw e;
+            this.images = before.images;
+            this.files = before.files;
+            return null;
+        }
+    }
     macroToMd(el) {
         const name = getAttr(el, 'ac:name') ?? '';
+        const nativeMd = this.tryNativeMd(el, name);
+        if (nativeMd !== null) {
+            this.stats.native++;
+            return nativeMd;
+        }
         const markerMd = this.tryMacroMarker(el, name);
         if (markerMd !== null) {
             this.stats.markers++;
@@ -379,6 +531,110 @@ class Converter {
         return this.verifyMacroMarker(el, markerMd) ? markerMd : null;
     }
     /** Маркер → render-конвейер → канонически равен исходному макросу? */
+    /** Таблица details → нормализованный GFM: пустые колонки (нумерация) отброшены,
+     * заголовок синтезируется («Поле|Значение» для двух колонок). null — не таблица. */
+    /** Убирает ac:/ri:-вставки без текста (упоминания пользователей, эмодзи):
+     * в md им нечем быть, а их присутствие роняло flatten всей ячейки. */
+    stripEmptyNamespaced(nodes) {
+        const out = [];
+        for (const n of nodes) {
+            if (n.kind === 'el') {
+                if (n.name.includes(':') && textContent(n.children).trim() === '')
+                    continue;
+                out.push({ ...n, children: this.stripEmptyNamespaced(n.children) });
+            }
+            else
+                out.push(n);
+        }
+        return out;
+    }
+    /** Таблица details → нормализованный GFM: пустые колонки (нумерация) отброшены,
+     * заголовок синтезируется («Поле|Значение» для двух колонок). Ячейки — readable-
+     * flatten; несовместимые вставки (напр. упоминание пользователя) — в голый текст.
+     * null — не таблица/пусто. */
+    propertiesGridMd(table) {
+        const saved = this.readable;
+        this.readable = true;
+        try {
+            const trs = [];
+            for (const child of elements(table.children)) {
+                if (['thead', 'tbody', 'tfoot'].includes(child.name)) {
+                    for (const tr of elements(child.children))
+                        if (tr.name === 'tr')
+                            trs.push(tr);
+                }
+                else if (child.name === 'tr')
+                    trs.push(child);
+            }
+            if (trs.length === 0)
+                return null;
+            const grid = trs.map((tr) => elements(tr.children)
+                .filter((c) => c.name === 'td' || c.name === 'th')
+                .map((c) => {
+                let flat;
+                try {
+                    flat = this.cellFlatten(this.stripEmptyNamespaced(c.children));
+                }
+                catch (e) {
+                    if (!(e instanceof Unrepresentable))
+                        throw e;
+                    flat = textContent(c.children);
+                }
+                return flat.replace(/\s+/g, ' ').trim();
+            }));
+            const cols = Math.max(...grid.map((r) => r.length));
+            const norm = grid.map((r) => Array.from({ length: cols }, (_, i) => r[i] ?? ''));
+            const keep = Array.from({ length: cols }, (_, i) => norm.some((r) => r[i] !== ''));
+            const rows = norm.map((r) => r.filter((_, i) => keep[i])).filter((r) => r.some((c) => c !== ''));
+            const width = rows[0]?.length ?? 0;
+            if (width === 0 || rows.some((r) => r.length !== width))
+                return null;
+            const esc = (s) => s.replace(/\|/g, '\\|');
+            const header = width === 2 ? ['Поле', 'Значение'] : rows[0].map(() => ' ');
+            const line = (cells) => `| ${cells.map(esc).join(' | ')} |`;
+            const md = [line(header), `| ${header.map(() => '---').join(' | ')} |`, ...rows.map(line)].join('\n');
+            return { md, rows };
+        }
+        finally {
+            this.readable = saved;
+        }
+    }
+    /** Нормализованные details: рендерим кандидата и сверяем ТЕКСТ ячеек с исходным. */
+    verifyNormalizedDetails(candidate, rows) {
+        try {
+            let storage = renderToStorage(candidate, { images: new Map(), files: new Map() }, { imageStyle: 'attachment', fileStyle: 'attachment', linkify: false });
+            storage = processMacros(storage, this.registry).toString();
+            let renderedTable = null;
+            const walk = (ns) => {
+                for (const n of elements(ns)) {
+                    if (renderedTable)
+                        return;
+                    if (n.name === 'table') {
+                        renderedTable = n;
+                        return;
+                    }
+                    walk(n.children);
+                }
+            };
+            walk(parseStorage(storage));
+            if (!renderedTable)
+                return false;
+            const backNorm = this.propertiesGridMd(renderedTable);
+            if (backNorm === null)
+                return false;
+            const back = backNorm.rows;
+            const width = rows[0]?.length ?? 0;
+            const headerIsSynth = back.length > 0 &&
+                (width === 2 ? back[0][0] === 'Поле' && back[0][1] === 'Значение' : back[0].every((c) => c === ''));
+            const body = headerIsSynth ? back.slice(1) : back;
+            if (body.length !== rows.length)
+                return false;
+            return body.every((r, i) => r.length === rows[i].length && r.every((c, j) => c === rows[i][j]));
+        }
+        catch {
+            return false;
+        }
+    }
     verifyMacroMarker(el, markerMd) {
         try {
             let storage = renderToStorage(markerMd, { images: new Map(), files: new Map() }, { imageStyle: 'attachment', fileStyle: 'attachment', linkify: false });

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export { authHeader, loadConfigFromEnv, type ConfluenceAuthType, type Confluence
 export { Markdown } from './markdown/markdown.js';
 export { renderToStorage, extractPlaceholders, parsePlaceholder, renameImagePlaceholders, MissingAttachmentUrlError, PLACEHOLDER_RE, type AttachmentUrls, type ExtractedPlaceholders, type PlaceholderRef, type RenderStorageOptions, } from './markdown/render.js';
 export { validateMarkdown, MarkdownValidationError, type ValidateOptions } from './markdown/validate.js';
+export { nativeToMarkers, nativeMacroList, NATIVE_ADMONITIONS, NATIVE_DIRECTIVES, NATIVE_PLACEHOLDERS, } from './markdown/native.js';
 export * from './macros/index.js';
 export { convertBpmn, convertBpmnFolder, isBpmnFile, bpmnOutputName, BPMN_FILE_RE, type BpmnConversion, type BpmnImageFormat, type ConvertBpmnFolderOptions, } from './bpmn/convert.js';
 export { fileSha256, HASH_TAG_PREFIX } from './attachments/hash.js';

package/dist/index.js

@@ -5,6 +5,7 @@ export { authHeader, loadConfigFromEnv, } from './client/config.js';
 export { Markdown } from './markdown/markdown.js';
 export { renderToStorage, extractPlaceholders, parsePlaceholder, renameImagePlaceholders, MissingAttachmentUrlError, PLACEHOLDER_RE, } from './markdown/render.js';
 export { validateMarkdown, MarkdownValidationError } from './markdown/validate.js';
+export { nativeToMarkers, nativeMacroList, NATIVE_ADMONITIONS, NATIVE_DIRECTIVES, NATIVE_PLACEHOLDERS, } from './markdown/native.js';
 // Macros (pluggable)
 export * from './macros/index.js';
 // BPMN (optional peer dep 'bpmn-to-image' is loaded lazily on use)

package/dist/markdown/native.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Нативный Markdown-синтаксис для популярных макросов Confluence.
+ * Сахар над маркерами <!-- MACRO:start/end -->: перед рендером native-
+ * конструкции переписываются в маркеры (nativeToMarkers), а экспорт
+ * (storage → md) эмитит их обратно с канонической верификацией.
+ *
+ * Перечень (см. README, раздел «Нативные макросы»):
+ *
+ *  Панели (admonition в стиле GitHub):
+ *    > [!INFO] Заголовок          → info   (заголовок опционален)
+ *    > [!NOTE] / [!WARNING] / [!TIP] → note / warning / tip
+ *    > текст панели — обычные строки цитаты после тега.
+ *
+ *  Блоки-директивы (fenced ::: … :::):
+ *    ::: properties [id=x] [hidden=true]   → details («Свойства страницы»;
+ *      тело — обычная md-таблица)            работает с отчётом detailssummary
+ *    ::: expand Заголовок                  → expand (разворачиваемый блок)
+ *    ::: panel title=… borderColor=…       → panel
+ *
+ *  Строчные плейсхолдеры (семейство {{img:}}/{{page:}}):
+ *    {{toc}} / {{toc:maxLevel=3}}          → toc (оглавление)
+ *    {{children}} / {{children:depth=2}}   → children (дочерние страницы)
+ *    {{jira:DR-123}}                       → jira (карточка задачи)
+ *    {{jira:jql=project = DR|maximumIssues=20}} → jira (выгрузка по JQL)
+ *    {{status:Готово|colour=Green}}        → status (лейбл)
+ *    {{anchor:имя}}                        → anchor (якорь)
+ *    {{properties-report:cql=label = "x"}} → detailssummary (отчёт по
+ *                                            свойствам страниц)
+ *
+ * Внутри fenced-код-блоков (``` / ~~~) синтаксис не интерпретируется.
+ */
+/** Панели: тег admonition → имя макроса. */
+export declare const NATIVE_ADMONITIONS: Record<string, string>;
+/** Блоки-директивы: имя директивы → имя макроса. */
+export declare const NATIVE_DIRECTIVES: Record<string, string>;
+/** Строчные плейсхолдеры: имя → имя макроса. */
+export declare const NATIVE_PLACEHOLDERS: Record<string, string>;
+/** Полный перечень макросов с нативной md-разметкой (для документации/UI). */
+export declare function nativeMacroList(): {
+    macro: string;
+    syntax: string;
+}[];
+/**
+ * Переписывает нативные конструкции в маркеры макросов. Идемпотентна для
+ * текста без нативного синтаксиса; содержимое fenced-код-блоков не трогает.
+ */
+export declare function nativeToMarkers(src: string): string;

package/dist/markdown/native.js

@@ -0,0 +1,232 @@
+/**
+ * Нативный Markdown-синтаксис для популярных макросов Confluence.
+ * Сахар над маркерами <!-- MACRO:start/end -->: перед рендером native-
+ * конструкции переписываются в маркеры (nativeToMarkers), а экспорт
+ * (storage → md) эмитит их обратно с канонической верификацией.
+ *
+ * Перечень (см. README, раздел «Нативные макросы»):
+ *
+ *  Панели (admonition в стиле GitHub):
+ *    > [!INFO] Заголовок          → info   (заголовок опционален)
+ *    > [!NOTE] / [!WARNING] / [!TIP] → note / warning / tip
+ *    > текст панели — обычные строки цитаты после тега.
+ *
+ *  Блоки-директивы (fenced ::: … :::):
+ *    ::: properties [id=x] [hidden=true]   → details («Свойства страницы»;
+ *      тело — обычная md-таблица)            работает с отчётом detailssummary
+ *    ::: expand Заголовок                  → expand (разворачиваемый блок)
+ *    ::: panel title=… borderColor=…       → panel
+ *
+ *  Строчные плейсхолдеры (семейство {{img:}}/{{page:}}):
+ *    {{toc}} / {{toc:maxLevel=3}}          → toc (оглавление)
+ *    {{children}} / {{children:depth=2}}   → children (дочерние страницы)
+ *    {{jira:DR-123}}                       → jira (карточка задачи)
+ *    {{jira:jql=project = DR|maximumIssues=20}} → jira (выгрузка по JQL)
+ *    {{status:Готово|colour=Green}}        → status (лейбл)
+ *    {{anchor:имя}}                        → anchor (якорь)
+ *    {{properties-report:cql=label = "x"}} → detailssummary (отчёт по
+ *                                            свойствам страниц)
+ *
+ * Внутри fenced-код-блоков (``` / ~~~) синтаксис не интерпретируется.
+ */
+import { escapeParamValue } from '../macros/builder.js';
+/** Панели: тег admonition → имя макроса. */
+export const NATIVE_ADMONITIONS = {
+    INFO: 'info',
+    NOTE: 'note',
+    WARNING: 'warning',
+    TIP: 'tip',
+};
+/** Блоки-директивы: имя директивы → имя макроса. */
+export const NATIVE_DIRECTIVES = {
+    properties: 'details',
+    expand: 'expand',
+    panel: 'panel',
+};
+/** Строчные плейсхолдеры: имя → имя макроса. */
+export const NATIVE_PLACEHOLDERS = {
+    toc: 'toc',
+    children: 'children',
+    jira: 'jira',
+    status: 'status',
+    anchor: 'anchor',
+    'properties-report': 'detailssummary',
+};
+/** Полный перечень макросов с нативной md-разметкой (для документации/UI). */
+export function nativeMacroList() {
+    return [
+        { macro: 'info', syntax: '> [!INFO] Заголовок?' },
+        { macro: 'note', syntax: '> [!NOTE] Заголовок?' },
+        { macro: 'warning', syntax: '> [!WARNING] Заголовок?' },
+        { macro: 'tip', syntax: '> [!TIP] Заголовок?' },
+        { macro: 'details', syntax: '::: properties [id=…] [hidden=true] … :::' },
+        { macro: 'expand', syntax: '::: expand Заголовок … :::' },
+        { macro: 'panel', syntax: '::: panel title=… … :::' },
+        { macro: 'toc', syntax: '{{toc}} | {{toc:maxLevel=3}}' },
+        { macro: 'children', syntax: '{{children}} | {{children:depth=2}}' },
+        { macro: 'jira', syntax: '{{jira:KEY-1}} | {{jira:jql=…|maximumIssues=20}}' },
+        { macro: 'status', syntax: '{{status:Текст|colour=Green|subtle=true}}' },
+        { macro: 'anchor', syntax: '{{anchor:имя}}' },
+        { macro: 'detailssummary', syntax: '{{properties-report:cql=…|firstcolumn=…}}' },
+    ];
+}
+const ADMONITION_FIRST_RE = /^>\s*\[!([A-Za-z]+)\]\s*(.*)$/;
+const DIRECTIVE_OPEN_RE = /^:::\s+([a-z-]+)(?:\s+(.*?))?\s*$/;
+const DIRECTIVE_CLOSE_RE = /^:::\s*$/;
+const PLACEHOLDER_INLINE_RE = /\{\{(toc|children|jira|status|anchor|properties-report)(?::((?:[^{}]|\{[^{])*?))?\}\}/g;
+const FENCE_RE = /^\s*(`{3,}|~{3,})/;
+/** Компактная пара маркеров без тела — для строчного контекста. */
+function inlineMarker(macroName, params) {
+    const paramStr = params.length
+        ? ':' + params.map((p) => `${escapeParamValue(p.name)}=${escapeParamValue(p.value)}`).join(':')
+        : '';
+    return `<!-- MACRO:start:${macroName}${paramStr} --><!-- MACRO:end:${macroName} -->`;
+}
+function blockMarker(macroName, params, body) {
+    const paramStr = params.length
+        ? ':' + params.map((p) => `${escapeParamValue(p.name)}=${escapeParamValue(p.value)}`).join(':')
+        : '';
+    return `<!-- MACRO:start:${macroName}${paramStr} -->\n${body}\n<!-- MACRO:end:${macroName} -->`;
+}
+/** `a|b=c|d=e` → первый сегмент + пары; поведение как у parsePlaceholder. */
+function splitAttrs(raw) {
+    const parts = raw.split('|');
+    const attrs = [];
+    for (const part of parts.slice(1)) {
+        const eq = part.indexOf('=');
+        if (eq === -1)
+            attrs.push({ name: part.trim(), value: '' });
+        else
+            attrs.push({ name: part.slice(0, eq).trim(), value: part.slice(eq + 1).trim() });
+    }
+    return { head: parts[0].trim(), attrs };
+}
+/** Параметры плейсхолдера → параметры макроса Confluence. */
+function placeholderParams(kind, raw) {
+    if (raw === undefined || raw.trim() === '')
+        return [];
+    const { head, attrs } = splitAttrs(raw);
+    const params = [];
+    const headIsPair = head.includes('=');
+    if (headIsPair) {
+        const eq = head.indexOf('=');
+        attrs.unshift({ name: head.slice(0, eq).trim(), value: head.slice(eq + 1).trim() });
+    }
+    switch (kind) {
+        case 'jira':
+            if (!headIsPair && head !== '')
+                params.push({ name: 'key', value: head });
+            break;
+        case 'status':
+            if (!headIsPair && head !== '')
+                params.push({ name: 'title', value: head });
+            break;
+        case 'anchor':
+            if (!headIsPair && head !== '')
+                params.push({ name: 'name', value: head });
+            break;
+        default:
+            // toc/children/properties-report: только k=v-атрибуты.
+            if (!headIsPair && head !== '')
+                params.push({ name: head, value: '' });
+    }
+    for (const a of attrs) {
+        // jira: короткое `jql=` — алиас родного jqlQuery.
+        if (kind === 'jira' && a.name === 'jql')
+            params.push({ name: 'jqlQuery', value: a.value });
+        else
+            params.push(a);
+    }
+    return params;
+}
+function replaceInline(line) {
+    return line.replace(PLACEHOLDER_INLINE_RE, (_full, kind, raw) => inlineMarker(NATIVE_PLACEHOLDERS[kind], placeholderParams(kind, raw)));
+}
+/** Параметры директивы: токены `k=v` (значение можно в кавычках) + свободный текст → title. */
+function directiveParams(name, rest) {
+    const params = [];
+    if (!rest)
+        return params;
+    const free = [];
+    const re = /([A-Za-z-]+)=("([^"]*)"|\S+)|(\S+)/g;
+    for (const m of rest.matchAll(re)) {
+        if (m[1])
+            params.push({ name: m[1], value: m[3] ?? m[2] });
+        else
+            free.push(m[4]);
+    }
+    if (free.length && name === 'expand')
+        params.unshift({ name: 'title', value: free.join(' ') });
+    return params;
+}
+/**
+ * Переписывает нативные конструкции в маркеры макросов. Идемпотентна для
+ * текста без нативного синтаксиса; содержимое fenced-код-блоков не трогает.
+ */
+export function nativeToMarkers(src) {
+    const lines = src.split('\n');
+    const out = [];
+    let fence = null;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const fm = FENCE_RE.exec(line);
+        if (fm) {
+            if (fence === null)
+                fence = fm[1][0];
+            else if (fm[1][0] === fence)
+                fence = null;
+            out.push(line);
+            continue;
+        }
+        if (fence !== null) {
+            out.push(line);
+            continue;
+        }
+        // ── Панели: > [!TYPE] Заголовок? ─────────────────────────────────────
+        const am = ADMONITION_FIRST_RE.exec(line);
+        const macroName = am ? NATIVE_ADMONITIONS[am[1].toUpperCase()] : undefined;
+        if (am && macroName) {
+            const body = [];
+            let j = i + 1;
+            for (; j < lines.length && /^>( |$)/.test(lines[j]); j++) {
+                body.push(lines[j].replace(/^> ?/, ''));
+            }
+            const params = am[2].trim() ? [{ name: 'title', value: am[2].trim() }] : [];
+            out.push(blockMarker(macroName, params, nativeToMarkers(body.join('\n'))));
+            i = j - 1;
+            continue;
+        }
+        // ── Директивы: ::: name … / ::: ──────────────────────────────────────
+        const dm = DIRECTIVE_OPEN_RE.exec(line);
+        const dirMacro = dm ? NATIVE_DIRECTIVES[dm[1]] : undefined;
+        if (dm && dirMacro) {
+            const body = [];
+            let j = i + 1;
+            let innerFence = null;
+            let closed = false;
+            for (; j < lines.length; j++) {
+                const bl = lines[j];
+                const bfm = FENCE_RE.exec(bl);
+                if (bfm) {
+                    if (innerFence === null)
+                        innerFence = bfm[1][0];
+                    else if (bfm[1][0] === innerFence)
+                        innerFence = null;
+                }
+                else if (innerFence === null && DIRECTIVE_CLOSE_RE.test(bl)) {
+                    closed = true;
+                    break;
+                }
+                body.push(bl);
+            }
+            if (closed) {
+                out.push(blockMarker(dirMacro, directiveParams(dm[1], dm[2]), nativeToMarkers(body.join('\n'))));
+                i = j;
+                continue;
+            }
+            // Незакрытая директива — оставляем как текст.
+        }
+        out.push(replaceInline(line));
+    }
+    return out.join('\n');
+}

package/dist/markdown/render.js

@@ -1,4 +1,5 @@
 import MarkdownIt from 'markdown-it';
+import { nativeToMarkers } from './native.js';
 // xhtmlOut: true — Confluence storage format = XHTML, void-элементы
 // (<hr/>, <br/>, <img/>) обязаны быть самозакрывающимися.
 // html: true — разрешить HTML (нужно для <!-- MACRO:... --> комментариев)
@@ -106,6 +107,9 @@ export class MissingAttachmentUrlError extends Error {
  * посимвольно.
  */
 export function renderToStorage(markdown, urls, opts = {}) {
+    // Нативный md-синтаксис макросов (панели, ::: properties, {{toc}} …) —
+    // сахар над маркерами: переписываем до markdown-it (см. native.ts).
+    markdown = nativeToMarkers(markdown);
     const renderer = opts.linkify === false ? mdNoLinkify : md;
     let html = renderer.render(markdown);
     // ```confluence-storage — транспорт для дословного XHTML (ac:/ri:-теги

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "confluence-md-sync",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "Publish Markdown to Confluence (Data Center & Cloud): idempotent page sync, attachment dedup, tables and a pluggable macro system",
   "keywords": [
     "confluence",