diff --git a/README.md b/README.md
index af66ee55217385a04afc50c4410cc1a7f29854ea..2e9eca2af421271ff530fb8a9137de9523a13e94 100644
--- a/README.md
+++ b/README.md
@@ -196,6 +196,9 @@ data or mind maps.
* [Mindmap](examples/mindmap.md)
* [Gantt Diagram](examples/gantt.md)
* [Visualising Software Architecture with the C4 Model](examples/c4.md)
+* [Vega](https://vega.github.io) diagrams:
+ * [Bar plots](examples/vega-barchart.md)
+ * [Wordcloud](examples/vega-wordcloud.md)
* [GraphViz](examples/graphviz.md)
* [Block Diagrams](examples/blockdiag.md)
diff --git a/examples/vega-barchart.md b/examples/vega-barchart.md
new file mode 100644
index 0000000000000000000000000000000000000000..676f48dc2f64ee8a491bf4dd5252539197885ca2
--- /dev/null
+++ b/examples/vega-barchart.md
@@ -0,0 +1,340 @@
+# Vega Bar Chart
+
+<details>
+ <summary>Show code</summary>
+ <div>
+
+ ```vega
+ {
+ "$schema": "https://vega.github.io/schema/vega/v5.json",
+ "description": "A nested bar chart example, with bars grouped by category.",
+ "width": 300,
+ "padding": 5,
+ "autosize": "pad",
+
+ "signals": [
+ {
+ "name": "rangeStep", "value": 20,
+ "bind": {"input": "range", "min": 5, "max": 50, "step": 1}
+ },
+ {
+ "name": "innerPadding", "value": 0.1,
+ "bind": {"input": "range", "min": 0, "max": 0.7, "step": 0.01}
+ },
+ {
+ "name": "outerPadding", "value": 0.2,
+ "bind": {"input": "range", "min": 0, "max": 0.4, "step": 0.01}
+ },
+ {
+ "name": "height",
+ "update": "trellisExtent[1]"
+ }
+ ],
+
+ "data": [
+ {
+ "name": "tuples",
+ "values": [
+ {"a": 0, "b": "a", "c": 6.3},
+ {"a": 0, "b": "a", "c": 4.2},
+ {"a": 0, "b": "b", "c": 6.8},
+ {"a": 0, "b": "c", "c": 5.1},
+ {"a": 1, "b": "b", "c": 4.4},
+ {"a": 2, "b": "b", "c": 3.5},
+ {"a": 2, "b": "c", "c": 6.2}
+ ],
+ "transform": [
+ {
+ "type": "aggregate",
+ "groupby": ["a", "b"],
+ "fields": ["c"],
+ "ops": ["average"],
+ "as": ["c"]
+ }
+ ]
+ },
+ {
+ "name": "trellis",
+ "source": "tuples",
+ "transform": [
+ {
+ "type": "aggregate",
+ "groupby": ["a"]
+ },
+ {
+ "type": "formula", "as": "span",
+ "expr": "rangeStep * bandspace(datum.count, innerPadding, outerPadding)"
+ },
+ {
+ "type": "stack",
+ "field": "span"
+ },
+ {
+ "type": "extent",
+ "field": "y1",
+ "signal": "trellisExtent"
+ }
+ ]
+ }
+ ],
+
+ "scales": [
+ {
+ "name": "xscale",
+ "domain": {"data": "tuples", "field": "c"},
+ "nice": true,
+ "zero": true,
+ "round": true,
+ "range": "width"
+ },
+ {
+ "name": "color",
+ "type": "ordinal",
+ "range": "category",
+ "domain": {"data": "trellis", "field": "a"}
+ }
+ ],
+
+ "axes": [
+ { "orient": "bottom", "scale": "xscale", "domain": true }
+ ],
+
+ "marks": [
+ {
+ "type": "group",
+
+ "from": {
+ "data": "trellis",
+ "facet": {
+ "name": "faceted_tuples",
+ "data": "tuples",
+ "groupby": "a"
+ }
+ },
+
+ "encode": {
+ "enter": {
+ "x": {"value": 0},
+ "width": {"signal": "width"}
+ },
+ "update": {
+ "y": {"field": "y0"},
+ "y2": {"field": "y1"}
+ }
+ },
+
+ "scales": [
+ {
+ "name": "yscale",
+ "type": "band",
+ "paddingInner": {"signal": "innerPadding"},
+ "paddingOuter": {"signal": "outerPadding"},
+ "round": true,
+ "domain": {"data": "faceted_tuples", "field": "b"},
+ "range": {"step": {"signal": "rangeStep"}}
+ }
+ ],
+
+ "axes": [
+ { "orient": "left", "scale": "yscale",
+ "ticks": false, "domain": false, "labelPadding": 4 }
+ ],
+
+ "marks": [
+ {
+ "type": "rect",
+ "from": {"data": "faceted_tuples"},
+ "encode": {
+ "enter": {
+ "x": {"value": 0},
+ "x2": {"scale": "xscale", "field": "c"},
+ "fill": {"scale": "color", "field": "a"},
+ "strokeWidth": {"value": 2}
+ },
+ "update": {
+ "y": {"scale": "yscale", "field": "b"},
+ "height": {"scale": "yscale", "band": 1},
+ "stroke": {"value": null},
+ "zindex": {"value": 0}
+ },
+ "hover": {
+ "stroke": {"value": "firebrick"},
+ "zindex": {"value": 1}
+ }
+ }
+ }
+ ]
+ }
+ ]
+ }
+ ```
+
+ </div>
+</details>
+
+```vega
+{
+ "$schema": "https://vega.github.io/schema/vega/v5.json",
+ "description": "A nested bar chart example, with bars grouped by category.",
+ "width": 300,
+ "padding": 5,
+ "autosize": "pad",
+
+ "signals": [
+ {
+ "name": "rangeStep", "value": 20,
+ "bind": {"input": "range", "min": 5, "max": 50, "step": 1}
+ },
+ {
+ "name": "innerPadding", "value": 0.1,
+ "bind": {"input": "range", "min": 0, "max": 0.7, "step": 0.01}
+ },
+ {
+ "name": "outerPadding", "value": 0.2,
+ "bind": {"input": "range", "min": 0, "max": 0.4, "step": 0.01}
+ },
+ {
+ "name": "height",
+ "update": "trellisExtent[1]"
+ }
+ ],
+
+ "data": [
+ {
+ "name": "tuples",
+ "values": [
+ {"a": 0, "b": "a", "c": 6.3},
+ {"a": 0, "b": "a", "c": 4.2},
+ {"a": 0, "b": "b", "c": 6.8},
+ {"a": 0, "b": "c", "c": 5.1},
+ {"a": 1, "b": "b", "c": 4.4},
+ {"a": 2, "b": "b", "c": 3.5},
+ {"a": 2, "b": "c", "c": 6.2}
+ ],
+ "transform": [
+ {
+ "type": "aggregate",
+ "groupby": ["a", "b"],
+ "fields": ["c"],
+ "ops": ["average"],
+ "as": ["c"]
+ }
+ ]
+ },
+ {
+ "name": "trellis",
+ "source": "tuples",
+ "transform": [
+ {
+ "type": "aggregate",
+ "groupby": ["a"]
+ },
+ {
+ "type": "formula", "as": "span",
+ "expr": "rangeStep * bandspace(datum.count, innerPadding, outerPadding)"
+ },
+ {
+ "type": "stack",
+ "field": "span"
+ },
+ {
+ "type": "extent",
+ "field": "y1",
+ "signal": "trellisExtent"
+ }
+ ]
+ }
+ ],
+
+ "scales": [
+ {
+ "name": "xscale",
+ "domain": {"data": "tuples", "field": "c"},
+ "nice": true,
+ "zero": true,
+ "round": true,
+ "range": "width"
+ },
+ {
+ "name": "color",
+ "type": "ordinal",
+ "range": "category",
+ "domain": {"data": "trellis", "field": "a"}
+ }
+ ],
+
+ "axes": [
+ { "orient": "bottom", "scale": "xscale", "domain": true }
+ ],
+
+ "marks": [
+ {
+ "type": "group",
+
+ "from": {
+ "data": "trellis",
+ "facet": {
+ "name": "faceted_tuples",
+ "data": "tuples",
+ "groupby": "a"
+ }
+ },
+
+ "encode": {
+ "enter": {
+ "x": {"value": 0},
+ "width": {"signal": "width"}
+ },
+ "update": {
+ "y": {"field": "y0"},
+ "y2": {"field": "y1"}
+ }
+ },
+
+ "scales": [
+ {
+ "name": "yscale",
+ "type": "band",
+ "paddingInner": {"signal": "innerPadding"},
+ "paddingOuter": {"signal": "outerPadding"},
+ "round": true,
+ "domain": {"data": "faceted_tuples", "field": "b"},
+ "range": {"step": {"signal": "rangeStep"}}
+ }
+ ],
+
+ "axes": [
+ { "orient": "left", "scale": "yscale",
+ "ticks": false, "domain": false, "labelPadding": 4 }
+ ],
+
+ "marks": [
+ {
+ "type": "rect",
+ "from": {"data": "faceted_tuples"},
+ "encode": {
+ "enter": {
+ "x": {"value": 0},
+ "x2": {"scale": "xscale", "field": "c"},
+ "fill": {"scale": "color", "field": "a"},
+ "strokeWidth": {"value": 2}
+ },
+ "update": {
+ "y": {"scale": "yscale", "field": "b"},
+ "height": {"scale": "yscale", "band": 1},
+ "stroke": {"value": null},
+ "zindex": {"value": 0}
+ },
+ "hover": {
+ "stroke": {"value": "firebrick"},
+ "zindex": {"value": 1}
+ }
+ }
+ }
+ ]
+ }
+ ]
+}
+```
+
+Taken from <https://vega.github.io/vega/examples/nested-bar-chart/>.