Slides

A slide must always have a layout attribute referring to the name of a slide layout.

<slide layout="Title and content">
</slide>

A slide may have position attribute which defines where in the presentation the slide is to be added.

A slide consists of a number of placeholders.

<slide layout="Title and content">
  <placeholder type="text">
    Hello world!
  </placeholder>
</slide>

Each placeholder must have a type attribute, which can be either text, image, table. The type attribute defines how the content of the tag is to be interpreted.

Instead of name, a placeholder may be selected by its numeric index in the layout with idx (e.g. <placeholder idx="13" type="text">). Add the attribute remove (<placeholder idx="13" remove></placeholder>) to delete the placeholder from the slide.

The placeholders may also have a name attribute. This attribute should refer to a placeholder name in the slide layout.

<slide layout="Title and content">
  <placeholder type="text" name="Text Placeholder 1">Hello</placeholder>
  <placeholder type="text" name="Text Placeholder 2">World!</placeholder>
</slide>

If no placeholder name is defined the placeholders will be positioned in order.

<slide layout="Title and content">
  <placeholder type="text">First placeholder</placeholder>
  <placeholder type="text">Second placeholder</placeholder>
</slide>

The different placeholders types are defined below.

Text placeholders

Text placeholders may contain plain text or basic html. <p> and <li> tags are interpreted as paragraphs.

<placeholder type="text">
  Hello world!
</placeholder>

<placeholder type="text">
  <p>Hello Earth!</p>
  <p>Hello Mars!</p>
</placeholder>

<placeholder type="text" auto-size="text-to-fit-shape">
  <li>Hello Earth!</li>
  <li>Hello Mars!</li>
  <li>Hello Jupiter!</li>
  <li>Hello Saturn!</li>
  <li>Hello Uranus!</li>
</placeholder>

<strong>, <i>/<em> and <a> tags may be used for inline formating and linking, and they may be nested (e.g. <strong>bold and <em>italic</em></strong>). A <span style="color:#c62828"> colors the text with the given hex color.

A <p> or <li> may have a one-based level attribute (<p level="2">) which sets the paragraph level (indentation) as defined in the base presentation.

The auto-size attribute may be set to autosize either the text (text-to-fit-shape) or the shape (shape-to-fit-text).

<placeholder type="text">
  Hello <strong>world</strong>. Considering a <a href="http://outer.space">Mars</a>?
</placeholder>

Image placeholders

An image placeholder recognizes <img> tags and picks up the path (or url) to the image from the src attribute.

<placeholder type="image" vertical-alignment="top>
  <img src="path/to/image.png">
</placeholder>

Use attributes vertical-alignment (or va) and horizontal-alignment (or ha) for positioning.

Note that the placeholder explicitly has to be either a picture or an object placeholder. This has to be set manually in Powerpoint. At the moment of writing Google Slides does not support picture placeholders (neither does Libre Office).

Table placeholders

A table placeholder should contain an html table. All <tr> tags are parsed as rows. <td> and <th> tags are parsed as cells. The cells may contain same basic text formatting as paragraphs (<strong> for bold, <i> for italic etc).

Cells with class="value" are interpreted as numbers and right-aligned.

<thead> and <tbody> may be present, but does not bring any meaning. <caption> is _not_ parsed.

<placeholder type="table">
  <table>
      <tr>
        <td>Country</td>
        <td>Happiness</td>
      </tr>
      <tr>
        <td>Finland</td>
        <td class="value">9.5</td>
      </tr>
      <tr>
        <td>Sweden</td>
        <td class="value">8.5</td>
      </tr>
  </table>
</placeholder>

A table may also have a font-size attribute which sets the font size for the table, a row or a cell.

<placeholder type="table">
  <table font-size="10">
    <tr font-size="12">
      <td font-size="14">Country</td>
      <td>Happiness</td>
    </tr>
  </table>
</placeholder>

To specify the width of a column in a table, use the width attribute on the first row of the table. Width is specified in points (1pt = 1/72 inch).

<placeholder type="table">
  <table>
    <tr>
      <th scope="col" width="200">Kommun</th>
      <th scope="col" width="100">Placering i länet</th>
    </tr>
  </table>
</placeholder>

Notes

A slide may contain <notes> tag containing slide notes. The content will be parsed as text just as regular text placeholders.

<notes>
  <li>Here is an important thing to keep in mind!</<li>
</notes>

Presentation metadata

Presentation level metadata such as title, author and comments may be defined as attributes of a <presentation> tag. Available properties equals the core properties of the pptx library.

<presentation title="My Report" author="John Smith" created="2020-01-01">
</presentation>