### WML Bookmark Start Element Example

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/wml_bookmarks_hyperlinks.md

Illustrates the basic structure of a `w:bookmarkStart` element, including its required `w:id` and `w:name` attributes. This element marks the beginning of a named range in a Word document.

```xml
<w:bookmarkStart w:id="10" w:name="section_overview"/>
```

--------------------------------

### WML Field Instruction Text Example

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/wml_fields.md

Shows an example of the `<w:instrText>` element within a run, used to carry the field instruction string. Ensure `xml:space="preserve"` is used for instructions with leading/trailing spaces.

```xml
<w:r>
  <w:instrText xml:space="preserve"> PAGE \* MERGEFORMAT </w:instrText>
</w:r>
```

--------------------------------

### FILENAME Field Instruction Example

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/wml_fields.md

Illustrates the FILENAME field instruction with the \p switch to include the full path.

```plaintext
 FILENAME \p 
```

--------------------------------

### REF Field Instruction Example

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/wml_fields.md

Shows the REF field instruction for cross-referencing a bookmark.

```plaintext
 REF bookmark1 
```

--------------------------------

### Table Width Examples

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/wml_tables.md

Illustrates different ways to specify table widths using CT_TblWidth with various units like dxa, pct, and auto.

```xml
<w:tblW w:w="8640" w:type="dxa"/>
```

```xml
<w:tcW w:w="4320" w:type="dxa"/>
```

```xml
<w:tblW w:w="5000" w:type="pct"/>   <!-- 50.00% -->
```

```xml
<w:tblW w:w="0"    w:type="auto"/>
```

--------------------------------

### Minimal SpreadsheetML StyleSheet Example

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/sml_formatting.md

A complete, minimal example of a SpreadsheetML stylesheet, including fonts, fills, borders, cellStyleXfs, and cellXfs. This structure is essential for a valid workbook.

```xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<x:styleSheet xmlns:x="http://schemas.openxmlformats.org/spreadsheetml/2006/main">
  <x:fonts count="2">
    <x:font><x:sz val="11"/><x:name val="Calibri"/></x:font>
    <x:font><x:b/><x:sz val="11"/><x:name val="Calibri"/></x:font>
  </x:fonts>
  <x:fills count="2">
    <x:fill><x:patternFill patternType="none"/></x:fill>
    <x:fill><x:patternFill patternType="gray125"/></x:fill>
  </x:fills>
  <x:borders count="1">
    <x:border><x:left/><x:right/><x:top/><x:bottom/><x:diagonal/></x:border>
  </x:borders>
  <x:cellStyleXfs count="1">
    <x:xf numFmtId="0" fontId="0" fillId="0" borderId="0"/>
  </x:cellStyleXfs>
  <x:cellXfs count="2">
    <x:xf numFmtId="0" fontId="0" fillId="0" borderId="0" xfId="0"/>
    <x:xf numFmtId="0" fontId="1" fillId="0" borderId="0" xfId="0" applyFont="1"/>
  </x:cellXfs>
</x:styleSheet>
```

--------------------------------

### HYPERLINK Field Instruction Example

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/wml_fields.md

Demonstrates the HYPERLINK field instruction for creating an external hyperlink.

```plaintext
 HYPERLINK "https://example.com" 
```

--------------------------------

### DATE Field Instruction Example

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/wml_fields.md

Shows how to use the DATE field instruction with a custom format switch. The \@ switch specifies the date picture.

```plaintext
 DATE \@ "MMMM d, yyyy" 
```

--------------------------------

### SEQ Field Instruction Example

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/wml_fields.md

Illustrates the SEQ field instruction for creating sequential counters, with \* ARABIC specifying the numbering format.

```plaintext
 SEQ Figure \* ARABIC 
```

--------------------------------

### PAGEREF Field Instruction Example

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/wml_fields.md

Illustrates the PAGEREF field instruction to get the page number of a bookmark, using the \h switch to create a hyperlink.

```plaintext
 PAGEREF bookmark1 \h 
```

--------------------------------

### Run Performance Benches

Source: https://github.com/kaisery/ooxmlsdk/blob/main/AGENTS.md

Execute package and XML performance benchmarks for the 'ooxmlsdk-test' package.

```bash
cargo bench -p ooxmlsdk-test --bench perf
```

--------------------------------

### Run Full Test Suite

Source: https://github.com/kaisery/ooxmlsdk/blob/main/AGENTS.md

Execute the default full test lane for the entire workspace.

```bash
cargo test --workspace
```

--------------------------------

### Concrete Numbering Instance

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/wml_numbering.md

An example of a `<w:num>` element binding an abstract number definition to a specific list instance with a unique ID. It can override level settings like the starting value.

```xml
<w:num w:numId="1">
  <w:abstractNumId w:val="0"/>        <!-- references abstractNum/@abstractNumId -->
  <w:lvlOverride w:ilvl="0">          <!-- optional: override level 0 -->
    <w:startOverride w:val="1"/>       <!-- restart at 1 -->
  </w:lvlOverride>
</w:num>
```

--------------------------------

### Start Conditions for PML Animations

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/pml_animations.md

Defines when an animation or effect should start. Use 'indefin' to wait for a mouse click, '0' to start immediately after the previous element, or a specific millisecond value to delay the start.

```xml
<p:stCondLst>
  <p:cond delay="indefin"/>   <!-- wait for a mouse click -->
  <p:cond delay="0"/>         <!-- start immediately after previous -->
  <p:cond delay="500"/>       <!-- start 500 ms after previous -->
</p:stCondLst>
```

--------------------------------

### Single-Cell Array Formula Example

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/sml_formulas.md

An example of a single-cell array formula, where the `ref` attribute specifies the cell itself and the formula operates over ranges.

```xml
<x:c r="A1">
  <x:f t="array" ref="A1">SUM(B1:B3*C1:C3)</x:f>
  <x:v>32</x:v>
</x:c>
```

--------------------------------

### Page Numbering Format and Start

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/wml_headers_footers.md

Use this element to define the numbering format (e.g., decimal, Roman numerals) and the starting page number for a section.

```xml
<w:pgNumType w:fmt="decimal" w:start="1"/>
```

--------------------------------

### Point Bookmark Placement

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/wml_bookmarks_hyperlinks.md

Creates a zero-width bookmark at a specific insertion point by placing 'bookmarkStart' and 'bookmarkEnd' adjacently.

```xml
<w:p>
  <w:bookmarkStart w:id="12" w:name="target"/>
  <w:bookmarkEnd w:id="12"/>
  <w:r><w:t>Bookmark is at the start of this paragraph.</w:t></w:r>
</w:p>
```

--------------------------------

### Format All Code

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/particle.md

Apply code formatting to all files within the project using cargo fmt.

```bash
cargo fmt --all
```

--------------------------------

### Custom XML Data Store Item Payload Example

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/wml_custom_xml.md

An example of the XML payload for a custom XML data store item, conforming to a specified schema.

```xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<contacts xmlns="http://example.com/schema/contacts">
  <contact><name>Alice</name><email>alice@example.com</email></contact>
</contacts>
```

--------------------------------

### Starting a New Numbered List from 1

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/wml_numbering.md

Use <w:lvlOverride> with <w:startOverride> to begin a new numbered list from 1, independent of the main list definition.

```xml
<w:lvlOverride w:ilvl="0"><w:startOverride w:val="1"/></w:lvlOverride>
```

--------------------------------

### Level Text Format Examples

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/wml_numbering.md

Examples of format strings used in `<w:lvlText>` to define numbering appearance. `%N` is replaced by the counter value at level N-1.

```plaintext
%1.          → "1.", "2.", "3.", …           (decimal, level 0)
%1.%2        → "1.1", "1.2", "2.1", …       (two-level decimal)
(%1)         → "(1)", "(2)", …               (decimal with parens)
%1.%2.%3.    → "1.1.1.", "1.1.2.", …        (three-level)
•            → "•", "•", "•"                 (bullet; numFmt=bullet)
```

--------------------------------

### Excel Data Table Formula Example

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/sml_formulas.md

This is an example of an Excel data table formula, which is generated by Excel and not directly editable. It includes key attributes like dt2D, dtr, r1, r2, del1, and del2.

```xml
<x:f dt2d="1" dtr="1" r1="1" r2="1" del1="1" del2="1">SUM(A1:A10)</x:f>
```

--------------------------------

### Example of mc:AlternateContent with mc:Choice and mc:Fallback

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/mce.md

Demonstrates how mc:AlternateContent uses mc:Choice elements with 'Requires' attributes to select content based on namespace support. Includes a fallback for unsupported namespaces.

```xml
<mc:AlternateContent
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    xmlns:v3="http://example.com/v3"
    xmlns:v2="http://example.com/v2">
  <mc:Choice Requires="v3">
    <v3:newWidget color="blue"/>
  </mc:Choice>
  <mc:Choice Requires="v2">
    <v2:widget color="blue"/>
  </mc:Choice>
  <mc:Fallback>
    <legacyWidget/>
  </mc:Fallback>
</mc:AlternateContent>
```

--------------------------------

### SpreadsheetML Data Validation Examples

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/sml_validation.md

Provides examples of `<x:dataValidation>` rules for different types: whole number range, list selection, and custom formula. Ensure the `count` attribute matches the number of validation rules.

```xml
<x:dataValidations count="3">
  <x:dataValidation type="whole" operator="between"
                    allowBlank="1" showInputMessage="1" showErrorAlert="1"
                    errorTitle="Out of range" error="Enter 1–100."
                    promptTitle="Hint" prompt="Whole number 1 to 100."
                    sqref="A1:A10">
    <x:formula1>1</x:formula1>
    <x:formula2>100</x:formula2>
  </x:dataValidation>
  <x:dataValidation type="list" allowBlank="1" showDropDown="0"
                    sqref="B1:B10">
    <x:formula1>"red,green,blue"</x:formula1>
  </x:dataValidation>
  <x:dataValidation type="custom" errorStyle="warning"
                    sqref="C1">
    <x:formula1>LEN(C1)&lt;=10</x:formula1>
  </x:dataValidation>
</x:dataValidations>
```

--------------------------------

### Configure Text Body Properties

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/pml_text.md

Example demonstrating vertical text, bottom anchoring, and reduce-to-fit autofit for a text body. This configuration is useful for specific text orientations and fitting.

```xml
<a:bodyPr vert="vert" anchor="b">
  <a:normAutofit/>
</a:bodyPr>
```

--------------------------------

### Theme XML Structure Example

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/pml_themes.md

Defines the basic structure of a PresentationML theme XML file, including theme elements like color, font, and format schemes.

```xml
<a:theme xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"
         name="Office Theme">
  <a:themeElements>
    <a:clrScheme name="…">…</a:clrScheme>
    <a:fontScheme name="…">…</a:fontScheme>
    <a:fmtScheme name="…">…</a:fmtScheme>
  </a:themeElements>
</a:theme>
```

--------------------------------

### Conditional Formatting Block Example

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/sml_conditional.md

An example of a `<x:conditionalFormatting>` block applied to specific cell ranges. It includes two conditional formatting rules: one based on a cell's value and another based on a formula.

```xml
<x:conditionalFormatting sqref="A1:A10 C5:C8" pivot="0">
  <x:cfRule type="cellIs" priority="1" dxfId="0" operator="greaterThan">
    <x:formula>10</x:formula>
  </x:cfRule>
  <x:cfRule type="expression" priority="2" dxfId="1" stopIfTrue="0">
    <x:formula>MOD(ROW(),2)=0</x:formula>
  </x:cfRule>
</x:conditionalFormatting>
```

--------------------------------

### mc:ProcessContent Example

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/mce.md

Demonstrates the 'see-through wrapper' pattern using mc:ProcessContent. When an ignorable element (ext:group) matches mc:ProcessContent, its children are promoted instead of being discarded.

```xml
<w:document
    xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main"
    xmlns:ext="http://example.com/ext"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    mc:Ignorable="ext"
    mc:ProcessContent="ext:group">
  <w:body>
    <ext:group>
      <w:p><w:r><w:t>first</w:t></w:r></w:p>
      <w:p><w:r><w:t>second</w:t></w:r></w:p>
    </ext:group>
  </w:body>
</w:document>
```

```xml
<w:document xmlns:w="...">
  <w:body>
    <w:p><w:r><w:t>first</w:t></w:r></w:p>
    <w:p><w:r><w:t>second</w:t></w:r></w:p>
  </w:body>
</w:document>
```

--------------------------------

### Reference Generation Command

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/xlsx_pdf.md

Use LibreOffice headless mode to convert XLSX fixtures to PDF for reference generation. Ensure the output directory is specified.

```bash
soffice --headless --convert-to pdf --outdir <tmp> <fixture.xlsx>
```

--------------------------------

### Run Basic PDF Tests

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/docx_pdf_rendering.md

Execute the basic PDF tests for the ooxmlsdk-pdf crate. This is part of the validation loop.

```bash
cargo test -p ooxmlsdk-pdf
```

--------------------------------

### Build All Crates

Source: https://github.com/kaisery/ooxmlsdk/blob/main/ARCHITECTURE.md

Use this command to build all crates within the workspace. Ensure you are in the repository root.

```bash
cargo build --workspace
```

--------------------------------

### OLE Object with Package ProgID

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/wml_embedded.md

Example of an OLEObject tag using 'Package' ProgID for whole-package embedding.

```xml
<o:OLEObject ProgID="Package" Type="Embed" r:id="rId5" .../>
```

--------------------------------

### Example Numeric Cell

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/sml_cells.md

Represents a cell with a numeric value. This is the default type if the 't' attribute is absent.

```xml
<!-- Numeric (default type) -->
<x:c r="A1"><x:v>42</x:v></x:c>
```

--------------------------------

### Paragraph with Style and Run Formatting

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/wml_runs.md

Demonstrates a paragraph with a heading style and run-level formatting including bold text and a specific color. Revision save IDs are also included.

```xml
<w:p w:rsidR="00A1B2C3" w:rsidRDefault="00A1B2C3">
  <w:pPr>
    <w:pStyle w:val="Heading1"/>
  </w:pPr>
  <w:r w:rsidR="00A1B2C3">
    <w:rPr>
      <w:b/>
      <w:color w:val="1F4E79"/>
    </w:rPr>
    <w:t>Chapter Introduction</w:t>
  </w:r>
</w:p>
```

--------------------------------

### Notes Slide Relationships Example

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/pml_notes.md

Defines the back-references for a notes slide, linking to the main slide and its master.

```XML
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
  <Relationship Id="rId1"
    Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide"
    Target="../slides/slide1.xml"/>
  <Relationship Id="rId2"
    Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/notesMaster"
    Target="../notesMasters/notesMaster1.xml"/>
</Relationships>
```

--------------------------------

### Run Performance Benches

Source: https://github.com/kaisery/ooxmlsdk/blob/main/ARCHITECTURE.md

Executes package and XML performance benchmarks within the test suite.

```bash
cd ../ooxmlsdk-test-suite && cargo bench -p ooxmlsdk-test --bench perf
```

--------------------------------

### Standard Formula Example

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/sml_formulas.md

Illustrates a standard, single-cell formula where the `t` attribute can be omitted as 'normal' is the default type.

```xml
<x:c r="C1">
  <x:f>A1*B1</x:f>
  <x:v>42</x:v>
</x:c>
```

--------------------------------

### Minimal Paragraph Example

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/wml_runs.md

A basic paragraph containing only a single run with text. This is the simplest valid paragraph structure.

```xml
<w:p>
  <w:r>
    <w:t>Hello world</w:t>
  </w:r>
</w:p>
```

--------------------------------

### Run PDF Export Fixture Tests

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/docx_pdf_rendering.md

Execute the PDF export fixture tests for the ooxmlsdk-pdf-test crate. Use --nocapture to see test output.

```bash
cargo test -p ooxmlsdk-pdf-test -- --nocapture
```

--------------------------------

### Line Spacing Configuration

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/drawingml.md

Demonstrates how to set line spacing using percentage or points. Use `<a:spcPct>` for percentage-based spacing (100,000 = 100%) and `<a:spcPts>` for point-based spacing (100 units = 1 point).

```xml
<a:lnSpc>
    <a:spcPct val="150000"/>
</a:lnSpc>
```

```xml
<a:spcAft>
    <a:spcPts val="1200"/>
</a:spcAft>
```

--------------------------------

### STYLEREF Field Instruction Example

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/wml_fields.md

Shows the STYLEREF field instruction to retrieve text from a paragraph with a specific style.

```plaintext
 STYLEREF "Heading 1" 
```

--------------------------------

### Fast Integration Test Lane

Source: https://github.com/kaisery/ooxmlsdk/blob/main/AGENTS.md

Run a fast integration lane for common runtime and package behavior in the 'ooxmlsdk-test' package.

```bash
cargo test -p ooxmlsdk-test
```

--------------------------------

### Notes Slide with Two Paragraphs

Source: https://github.com/kaisery/ooxmlsdk/blob/main/docs/specs/pml_notes.md

An example of a notes slide containing two distinct paragraphs of speaker notes.

```XML
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<p:notes xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"
         xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main"
         xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships">
  <p:cSld>
    <p:spTree>
      <p:nvGrpSpPr>
        <p:cNvPr id="1" name=""/>
        <p:cNvGrpSpPr/>
        <p:nvPr/>
      </p:nvGrpSpPr>
      <p:grpSpPr>
        <a:xfrm>
          <a:off x="0" y="0"/>
          <a:ext cx="0" cy="0"/>
          <a:chOff x="0" y="0"/>
          <a:chExt cx="0" cy="0"/>
        </a:xfrm>
      </p:grpSpPr>

      <!-- Notes text area -->
      <p:sp>
        <p:nvSpPr>
          <p:cNvPr id="3" name="Notes Placeholder 2"/>
          <p:cNvSpPr><a:spLocks noGrp="1"/></p:cNvSpPr>
          <p:nvPr><p:ph type="body" idx="1"/></p:nvPr>
        </p:nvSpPr>
        <p:spPr/>
        <p:txBody>
          <a:bodyPr/>
          <a:lstStyle/>
          <a:p>
            <a:r>
              <a:rPr lang="en-US" dirty="0"/>
              <a:t>First paragraph of speaker notes.</a:t>
            </a:r>
          </a:p>
          <a:p>
            <a:r>
              <a:rPr lang="en-US" dirty="0"/>
              <a:t>Second paragraph with additional context.</a:t>
            </a:r>
          </a:p>
        </p:txBody>
      </p:sp>
    </p:spTree>
  </p:cSld>
</p:notes>
```