Ingebed PGN-commando

PGN staat voor Portable Game Notation, een tekstformaat voor het vastleggen van partijen. Een ingebed PGN-commando voegt machineleesbare gegevens toe en blijft compatibel met lezers die alleen gewoon commentaar begrijpen. Het staat binnen accoladecommentaar volgens de PGN-commentsyntaxis. De algemene vorm begint met [%, gaat verder met een commandonaam en parameters en eindigt met ].

In {[%clk 1:05:23]} is clk de commandonaam en 1:05:23 de parameter. Het supplement waarin deze conventie wordt gedocumenteerd, stelt clk voor om de klokweergave na een zet vast te leggen. Het beschrijft ook verschillende andere tijdgerelateerde commando's.

De conventie komt uit een supplement met de status definitief concept en niet uit de oorspronkelijke kernspecificatie van PGN. Het supplement legt bewust geen universele lijst van alle mogelijke commando's op. Interoperabiliteit hangt er daarom van af dat de producent en lezer dezelfde betekenis aan een commandonaam geven.

Software die een commando niet herkent, hoort het ongewijzigd als deel van het commentaar te bewaren. Dat verschilt van een PGN-tagpaar, dat beschrijvende gegevens in het openingsgedeelte van de partij opslaat en niet als commando binnen commentaar bij de zetten.