Documents with clear structure

Templates and examples

The A4 Word reference is adapted from TWR with Inter typography, Forest headings, an IVR symbol/name header, later-page title field, and page-number footer. It is a style reference, not a body-content template. The independent XeLaTeX header supplies IVR typography and colors for direct PDF output.

Tools and fonts

Use Pandoc 3.x for Word. PDF additionally needs XeLaTeX and the packages supplied by a TeX distribution. Install the Inter desktop fonts; code uses the separately available DejaVu Sans Mono family. Font CSS does not install desktop fonts.

Neither conversion requires a helper script. Templates and generated samples are maintained files; normal website builds copy them unchanged.

Create DOCX

Download report.md, ivr-workflow.png, and ivr-document-reference.docx into your working folder:

pandoc "report.md" --standalone \
  --reference-doc="ivr-document-reference.docx" --resource-path=. \
  -o "ivr-report.docx"

Create PDF

Download ivr-document.tex into that folder:

pandoc "report.md" --standalone --pdf-engine=xelatex \
  -V mainfont="Inter" -V monofont="DejaVu Sans Mono" \
  -V fontsize=11pt -V papersize=a4 -V geometry:margin=1in \
  --include-in-header="ivr-document.tex" --resource-path=. \
  -o "ivr-report.pdf"

The Word reference does not style this PDF; XeLaTeX has independent pagination and headers. Word custom styles such as Callout retain their text in PDF but do not automatically transfer shading or other Word formatting.

Structure and typography

The repository also preserves TWR’s optional convenience: make document INPUT=brief.md OUTPUT=build/brief.docx. For a .pdf output, scripts/render.sh renders the Word file using LibreOffice; this differs from the direct XeLaTeX PDF shown here. Pandoc defaults live in ivr-document-defaults.yaml. Normal website builds copy maintained examples and do not invoke either renderer.

Use Inter 28pt title, 12pt subtitle, 16/13/11pt headings, 11pt body, and 9pt captions. Keep long text left-aligned, tables narrow, figures captioned, and sources explicit. A4 uses 1-inch margins. Public output does not have an automatic Confidential footer.

The reference contains Callout paragraph and Label character styles. Modify named styles in Word/Writer for reusable changes. Refresh the Word TITLE field when needed. Review both renderers separately after changing page size.

Inspect the example

The preview is a XeLaTeX rendering, not a Microsoft Word screenshot. Check headings, tables, code, footnotes, fonts, page numbers, and page breaks in every requested format. Office package/XML validation and PDF inspection do not replace Microsoft Word validation.