La puissance du WikiTexte vient de sa capacité à utiliser le contenu d'un tiddler dans un autre. Cette capacité prend plusieurs formes qu'on peut facilement confondre.

La principale différence réside entre la transclusion et la substitution de texte :

• Une transclusion est remplacée dynamiquement avec l'une ou l'autre de ces valeurs :
  • un champ de tiddler
  • une variable
• Une substitution de texte est réalisée dans le texte de la définition de la macro avant son utilisation.

Transclusion de champ de tiddler

Transclusion en WikiTexte décrit les bases de la transclusion. Par exemple :

{{MonTiddler}}

Comme décrit dans HTML dans le WikiTexte, vous pouvez aussi transclure des valeurs de champs de tiddlers dans des attributs de balises HTML et de widgets. Par exemple :

<$text text={{MonTiddler}}/>

Comme décrit dans Introduction à la rédaction d'un filtre, vous pouvez aussi transclure des valeurs de champs de tiddlers dans des opérandes de filtres. Par exemple :

{{{ [tag{TiddlerContenantMonTag}] }}}

Transclusion de variable/macro

Les définitions de variables qui comportent des paramètres ou des substitutions sont nommées des « macros ». Vous pouvez transclure la valeur d'une variable/macro grâce à la syntaxe :

<<maMacro param:"Valeur d'attribut">>

Comme décrit dans HTML dans le WikiTexte, vous pouvez aussi transclure des valeurs de variables dans des attributs de balises HTML et de widgets. Par exemple :

<$text text=<<myMacro>>/>

Comme décrit dans Introduction à la rédaction d'un filtre, vous pouvez aussi transclure des valeurs de variables dans des opérandes de filtres. Par exemple :

{{{ [tag<maMacro>] }}}

Substitution de texte

La substitution de texte a lieu quand la valeur d'une macro/variable est utilisée. Ce mécanisme est décrit dans Macros en WikiTexte.

La différence principale entre la substitution et la transclusion est que la substitution a lieu avant l'analyse du WikiTexte, ce qui signifie que vous pouvez utiliser la substitution pour construire des assemblages de WikiTexte. Au contraire, les transclusions sont traitées indépendamment et ne peuvent pas être combinées avec du texte adjacent pour construire des assemblages de WikiTexte.