v1.1.0 — Add custom type remapping for alerts-normalize (info → note) via frontmatter

### Added
- Custom type remapping: allows mapping one alert type to another via frontmatter, e.g.:
  ```yaml
  alerts-normalize:
    out-format: pandoc-format
    custom-types:
      - info: note
  ```
- Improves flexibility when normalizing alerts across different output formats.

Author: pedro

CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [1.1.0] — 2026-03-29
+
+### Added
+
+- **Custom type remapping**: allow mapping one callout type to another via frontmatter, e.g.:
+
+```yaml
+alerts-normalize:
+  out-format: pandoc-format
+  custom-types:
+    - info: note
+```
+
+This remaps info alerts to note during normalization.
+
 ## \[1.0.0]
 
 ### Architecture

CITATION.cff

@@ -4,7 +4,7 @@ authors:
   - family-names: "Barrio"
     given-names: "Pedro Luis"
 title: "alerts-normalize.lua"
-version: 1.0.0
+version: 1.1.0
 date-released: 2026-03-22
 url: "https://github.com/plbarrio/alerts-normalize"
 license: GPL-3.0-or-later

Makefile

@@ -2,7 +2,7 @@
 #
 # Targets:
 #   test                  — run all tests
-#   test-pandoc           — plain Pandoc path (11 cases)
+#   test-pandoc           — plain Pandoc path (12 cases)
 #   test-quarto           — forced Quarto path via out-format: quarto-format (6 cases)
 #   test-quarto-pandoc    — Quarto runner + out-format: pandoc-format (5 cases, requires quarto)
 #   test-roundtrip        — round-trip through all readable formats via pandoc-md
@@ -12,6 +12,7 @@ INPUT_DIR     = test/input
 EXPECTED      = test/expected
 META_PANDOC   = $(INPUT_DIR)/alert-normalize-pandoc-mode.yaml
 META_QUARTO   = $(INPUT_DIR)/alert-normalize-quarto-mode.yaml
+META_TYPE_MAP = $(INPUT_DIR)/alert-normalize-type-map.yaml
 
 # strips pandoc-api-version from JSON output before comparing
 STRIP_VER = python3 -c "import sys,json; d=json.load(sys.stdin); d.pop('pandoc-api-version',None); d.pop('meta',None); print(json.dumps(d))"
@@ -24,7 +25,7 @@ STEP = pandoc -f markdown -t markdown --lua-filter=$(FILTER) --metadata alerts-n
         test-pandoc-rich test-pandoc-passthrough \
         test-pandoc-title test-pandoc-collapse test-pandoc-title-only \
         test-pandoc-custom-type test-pandoc-pandoc-md-source \
-        test-pandoc-quarto-titled \
+        test-pandoc-quarto-titled test-pandoc-type-map \
         test-quarto-basic test-quarto-empty test-quarto-multipara \
         test-quarto-rich test-quarto-passthrough test-quarto-titled \
         test-quarto-pandoc-basic test-quarto-pandoc-empty \
@@ -43,7 +44,7 @@ test-pandoc: test-pandoc-basic test-pandoc-empty test-pandoc-multipara \
              test-pandoc-rich test-pandoc-passthrough \
              test-pandoc-title test-pandoc-collapse test-pandoc-title-only \
              test-pandoc-custom-type test-pandoc-pandoc-md-source \
-             test-pandoc-quarto-titled
+             test-pandoc-quarto-titled test-pandoc-type-map
 
 test-pandoc-basic:
 	@echo -n "test-pandoc-basic: "
@@ -122,6 +123,13 @@ test-pandoc-quarto-titled:
 	| $(STRIP_VER) | diff - $(EXPECTED)/alert-normalize-quarto-titled-pandoc.json
 	@echo "OK"
 
+test-pandoc-type-map:
+	@echo -n "test-pandoc-type-map: "
+	@pandoc $(INPUT_DIR)/alert-normalize-type-map.md \
+	  --lua-filter=$(FILTER) --metadata-file=$(META_TYPE_MAP) -t json \
+	| $(STRIP_VER) | diff - $(EXPECTED)/alert-normalize-type-map-pandoc.json
+	@echo "OK"
+
 # --- Quarto forced via out-format: quarto-format ---
 
 test-quarto: test-quarto-basic test-quarto-empty test-quarto-multipara \
@@ -307,6 +315,10 @@ generate-pandoc:
 	  pandoc $(INPUT_DIR)/$$f.md --lua-filter=$(FILTER) -t json \
 	  | $(STRIP_VER) > $(EXPECTED)/$$f-pandoc.json && echo "OK"; \
 	done
+	@echo -n "  alert-normalize-type-map: "
+	@pandoc $(INPUT_DIR)/alert-normalize-type-map.md --lua-filter=$(FILTER) \
+	  --metadata-file=$(META_TYPE_MAP) -t json \
+	| $(STRIP_VER) > $(EXPECTED)/alert-normalize-type-map-pandoc.json && echo "OK"
 
 generate-quarto:
 	@echo "Generating quarto expected files..."

README.md

@@ -149,6 +149,9 @@ Quarto callout — no title needed.
 
 ## Configuration
 
+
+### Simple form
+
 The simplest form works on the command line and in frontmatter:
 
 ```sh
@@ -163,30 +166,23 @@ alerts-normalize: github-format
 ---
 ```
 
+### Nested form (custom types, remapping)
+
 For additional options, use the nested form in a metadata file or frontmatter:
 
 ```yaml
 alerts-normalize:
   out-format: pandoc-format
   custom-types:
     - spoiler
-    - exercise
-    - theorem
+    - exercise 
+    - info : note # remap info -> note
 ```
 
-### `out-format`
-
-Selects the output format. Auto-detected when omitted: `quarto-format` inside
-`quarto render`, `pandoc-format` otherwise.
-
-### `custom-types`
+* `out-format` — chooses the output format. Auto-detected when omitted: `quarto-format` inside Quarto, `pandoc-format` otherwise.
 
-Extends the built-in callout type whitelist with additional types. The built-in
-list covers the core types (`note`, `warning`, `tip`, `caution`, `important`)
-and extended types from Obsidian, MkDocs, MyST, Sphinx, and VitePress ecosystems.
+* `custom-types` — extends the built-in callout whitelist; supports **remapping** (`source: target`) and new types.
 
-Custom types from GitHub syntax (`> [!WORD]`) are always accepted regardless
-of the whitelist — the whitelist only applies to plain classed div detection.
 
 ## Output
 
@@ -241,7 +237,7 @@ Content.
 - Inline title capture: `> [!NOTE] My title`
 - Collapse support: `[!NOTE]-` collapsed, `[!NOTE]+` expanded
 - Extended callout type whitelist — 25 built-in types
-- Custom types via `custom-types` frontmatter option
+- Custom types via `custom-types` frontmatter option, with remapping
 - `pandoc-md` intermediate format for round-trip pipelines
 - No silent failures — unrecognised markers pass through unchanged
 

_extensions/alerts-normalize/_extension.yml

@@ -1,6 +1,6 @@
 title: alerts-normalize
 author: Pedro Luis Barrio
-version: 1.0.0
+version: 1.1.0
 quarto-required: ">=1.4.0"
 contributes:
   filters:

_extensions/alerts-normalize/alerts-normalize.lua

@@ -26,6 +26,7 @@ Per-document options (in frontmatter):
     custom-types:
       - spoiler
       - exercise
+      - info: note       # mapping: info renders as note
 
 See copyright notice in file LICENSE.
 ]]
@@ -231,6 +232,8 @@ end
 
 -- # Normalizers
 
+local TypeMap = {}  -- optional kind remapping, e.g. info -> note
+
 --- Known callout types for Pandoc/Sphinx plain div detection.
 local CalloutTypes = {
   -- core (all formats)
@@ -247,6 +250,7 @@ local CalloutTypes = {
 }
 
 local function make_div(kind, blocks, title, collapse)
+  kind = TypeMap[kind] or kind
   local attrs = {}
   if title and title ~= '' then attrs.title = title end
   if collapse == true  then attrs.collapse = 'true'  end
@@ -347,13 +351,23 @@ local function process_metadata(meta)
     --   out-format: pandoc-format
     --   custom-types:
     --     - spoiler
+    --     - info: note
     local fmt = cfg['out-format']
     out_format = fmt and pandoc.utils.stringify(fmt)
                       or (quarto ~= nil and 'quarto-format' or 'pandoc-format')
     local types = cfg['custom-types']
     if types then
       for _, v in ipairs(types) do
-        CalloutTypes[pandoc.utils.stringify(v)] = true
+        if type(v) == 'table' then
+          -- mapping form: { info: note }
+          for src, dst in pairs(v) do
+            CalloutTypes[src] = true
+            TypeMap[src] = pandoc.utils.stringify(dst)
+          end
+        else
+          -- plain string: spoiler
+          CalloutTypes[pandoc.utils.stringify(v)] = true
+        end
       end
     end
   end

examples/.gitignore

@@ -0,0 +1,2 @@
+/.quarto/
+**/*.quarto_ipynb

examples/Makefile

@@ -7,30 +7,19 @@ QOUTDIR       = output/quarto
 # Target lists (Filenames only)
 HTMLS        = $(INPUTS:.md=.html)
 EPUBS        = $(INPUTS:.md=.epub)
-PDFS_LATEX   = $(INPUTS:.md=-latex.pdf)
-PDFS_TYPST   = $(INPUTS:.md=-typst.pdf)
 
 .PHONY: all pandoc quarto html epub \
-        pdf-latex-quarto pdf-typst-quarto html-quarto epub-quarto \
+        pdf-latex-quarto pdf-typst-quarto \
         clean
 
 all: pandoc quarto
 
 # --- Grouped targets ---------------------------------------
 pandoc: html epub
 
-quarto: html-quarto epub-quarto
-	-$(MAKE) pdf-latex-quarto
-	-$(MAKE) pdf-typst-quarto
-
 # --- Target mapping -----------
-html:              $(addprefix $(OUTDIR)/,$(HTMLS))
-epub:              $(addprefix $(OUTDIR)/,$(EPUBS))
-
-html-quarto:       $(addprefix $(QOUTDIR)/,$(HTMLS))
-epub-quarto:       $(addprefix $(QOUTDIR)/,$(EPUBS))
-pdf-latex-quarto:  $(addprefix $(QOUTDIR)/,$(PDFS_LATEX))
-pdf-typst-quarto:  $(addprefix $(QOUTDIR)/,$(PDFS_TYPST))
+html:  $(addprefix $(OUTDIR)/,$(HTMLS))
+epub:  $(addprefix $(OUTDIR)/,$(EPUBS))
 
 $(OUTDIR) $(QOUTDIR):
 	mkdir -p $@
@@ -43,18 +32,17 @@ $(OUTDIR)/%.epub: %.md | $(OUTDIR)
 	-pandoc $(FILTERS) --css=./demo.css -o $@ $<
 
 # --- Quarto rules  ------------
-$(QOUTDIR)/%-latex.pdf: %.md | $(QOUTDIR)
-	-quarto render $< --to pdf --pdf-engine=lualatex --output-dir=$(QOUTDIR) --output $(notdir $@)
-
-$(QOUTDIR)/%-typst.pdf: %.md | $(QOUTDIR)
-	-quarto render $< --to typst --output-dir=$(QOUTDIR) --output $(notdir $@)
+quarto: | $(QOUTDIR)
+	-quarto render demo.md --to html
+	-quarto render demo.md --to epub
+	-$(MAKE) pdf-latex-quarto
+	-$(MAKE) pdf-typst-quarto
 
-$(QOUTDIR)/%.html: %.md | $(QOUTDIR)
-	-quarto render $< --to html --output-dir=$(QOUTDIR)
+pdf-latex-quarto: | $(QOUTDIR)
+	-quarto render demo.md --to pdf --pdf-engine=lualatex --output demo-latex.pdf
 
-$(QOUTDIR)/%.epub: %.md | $(QOUTDIR)
-	-quarto render $< --to epub --output-dir=$(QOUTDIR)
+pdf-typst-quarto: | $(QOUTDIR)
+	-quarto render demo.md --to typst --output demo-typst.pdf
 
 clean:
 	rm -rf output
-

examples/README.md

@@ -11,6 +11,8 @@ all supported input formats, output formats, and syntax variants.
   Pandoc 3.9, Quarto).
 - **`demo.css`**: GitHub Primer styles with Octicons (MIT License) embedded as
   Data URIs — generates self-contained, portable HTML.
+- **`example.qmd`**: Quarto entry point for the extension gallery — wraps `demo.md`.
+
 - **`Makefile`**: Build targets for all output formats.
 - **`_quarto.yml`**: Quarto project config declaring the filter at `pre-ast`.
 
@@ -19,20 +21,26 @@ all supported input formats, output formats, and syntax variants.
 ### Pandoc (lightweight)
 
 ```sh
-make html
+make pandoc
 ```
 
 Renders `demo.md` via Pandoc with `demo.css`. Fast, no Quarto required.
 
 ### Quarto (native callouts)
 
 ```sh
-make html-quarto
+make quarto
 ```
 
 Renders via `quarto render` — produces native styled callout boxes with icons,
 colours, and collapse behaviour.
 
+Altenatively you can just
+
+```sh
+quarto render example.qmd
+```
+
 ### All formats
 
 ```sh

examples/_quarto.yml

@@ -1,3 +1,6 @@
 filters:
   - at: pre-ast
     path: ../alerts-normalize.lua
+
+project:
+  output-dir: output/quarto