Brand Templates

Generation, conversion, API, and MCP workflows for branded Word and PowerPoint output.

Version 1.5.14

Shared workflow: CLI + API + MCP Cover-page detection: frontmatter, H1, Subject, Title Release notes published
Quick Download (Full Sample)

Alterspective Brand Templates

Complete branding solutions for Microsoft Word and PowerPoint. Pre-configured styles, theme colours, and typography ensure every document and presentation maintains consistent brand identity.

Word Documents (.docx)

40+ styles, 3 table styles, 12 callout boxes, legal numbering, cover pages, headers/footers with logo and classification.

PowerPoint Presentations (.pptx)

9 slide layouts, A-pattern title backgrounds, section dividers, quote slides, two-column layouts, and brand theme colours.

Shared Conversion Workflow

CLI, web API, and MCP now use the same conversion service, so defaults and branding stay aligned.

Title Detection

Cover pages and title slides can resolve from YAML frontmatter, the first H1, or `**Subject:**` / `**Title:**` lines.

Operational Visibility

Release notes, changelog entries, and the live health endpoint now track the shipped version together.

Getting Started

Follow these steps to start using Alterspective branded documents.

1

Install Brand Fonts

Install Chronicle Display (weights: Light, Roman, Semibold) and Montserrat (weights: Regular, Medium, Semibold, Bold) on your system. Right-click each font file and select "Install for all users".

2

Download the Template

Click the Download Template button above. Save the .docx file or generate a .dotx template using the CLI for installation to your Word templates folder.

3

Create New Document

Open the template in Word, or if you installed the .dotx file, go to File > New > Personal and select "Alterspective-Template".

4

Apply Styles

Use the Styles Gallery (Home tab) to apply branded styles. All Alterspective styles are visible in the Quick Styles gallery.

Tip: Legal-style heading numbering (1, 1.1, 1.1.1) is enabled by default. Use --no-legal-numbering when generating to disable it.

Template Downloads

Choose the template variant that suits your needs.

Word Templates

Blank Template

Just styles configured. No cover page or sample content. Perfect for starting from scratch.

With Cover Page

Includes branded cover page with A pattern. No sample content - ready for your document.

Full Sample

Cover page plus sample content demonstrating all styles, tables, and callouts.

PowerPoint Templates

Blank Template

Just slide layouts configured. No slides added. Start with a clean presentation.

Starter Template

Title slide, agenda, key insight, and basic slides. A quick-start foundation.

Full Sample

43 slides including icon library, diagrams, and example slides for all audiences.

Additional Resources

Generate via CLI

Use the CLI to generate templates with custom options.

alterspective-templates generate word --output ./templates alterspective-templates generate powerpoint --output ./templates

Brand Guidelines

Full brand guidelines including colours, typography, and logo usage.

Document Conversion

Convert your markdown documents to branded Word or PowerPoint files. Upload a .md file and download the converted document with full Alterspective branding applied.

Markdown to Word

Convert markdown to a branded Word document with theme colours, headers, footers, and cover-page support.

  • Cover page: on by default when a title is detected from frontmatter, the first H1, or **Subject:** / **Title:**.
  • Brand shell: generated documents keep the branded header/footer treatment and Alterspective theme colours.
  • Markdown handling: headings, tables, callouts, quotes, formulas, and diagrams follow the same shared converter used by CLI and MCP.
Accepts .md files only
PNG or JPEG for header/cover page

Markdown to PowerPoint

Convert markdown to a branded presentation with title slides, section dividers, content, quotes, tables, and diagrams.

  • Title slide: derived from frontmatter or other title detection rules shared with the Word converter.
  • Slide mapping: H1s become section dividers, H2 + bullets become content slides, and quote/admonition/insight patterns map to dedicated layouts.
  • Presentation options: choose 16:9 or 4:3 and optionally supply a logo for the title slide.
Accepts .md files only
PNG or JPEG for title slide
Markdown Format Tips:
  • Use YAML frontmatter for title/subtitle when you want predictable cover pages and title slides.
  • # Heading 1 becomes a section divider slide
  • ## Heading 2 followed by bullets becomes a content slide
  • > Quote text becomes a quote slide
  • **KEY INSIGHT:** creates a key insight slide
  • **Subject:** Proposal Title also works as a title fallback for branded Word covers

Word Styles Gallery

All styles available in the Alterspective Word Template, organised by category.

Title & Heading Styles

Title Chronicle Display Light, 36pt, Marine - for document titles Display
Subtitle Chronicle Display Light, 18pt, Marine - for document subtitles Display
Heading 1 Chronicle Display Roman, 28pt, Marine - major sections Display
Heading 2 Chronicle Display Roman, 22pt, Marine - subsections Display
Heading 3 Chronicle Display Semibold, 18pt, Marine - topics Display
Heading 4 Montserrat Bold UPPERCASE, 12pt, Navy - section labels Body

Body & Text Styles

Normal Montserrat Medium, 11pt, Navy - standard body text Body
No Spacing Same as Normal but without paragraph spacing Body
Quote Chronicle Display Light Italic, 14pt, Marine - introductions Display
Intense Quote Chronicle Display, 16pt, Marine with border - featured quotes Display

List Styles

List Bullet Bulleted list with Marine bullet points Body
List Number Numbered list with Marine numbers Body
List Paragraph Indented paragraph for list content Body

Special Styles

Code Block Consolas, 10pt, Navy on Pale Blue - for code samples Mono
Caption Montserrat, 9pt, Navy italic - for figures/tables Body
TOC Heading For Table of Contents heading System

Table Styles

Three branded table styles with professional formatting.

Alterspective Table (Navy)

Navy header with white text, alternating Pale Blue rows. The default table style.

Column AColumn BColumn C
Row 1DataData
Row 2DataData
Row 3DataData

Alterspective Table Marine

Marine header with white text, alternating Pale Blue rows.

Column AColumn BColumn C
Row 1DataData
Row 2DataData

Alterspective Table Light

Marine header, subtle borders, clean appearance for minimal designs.

Column AColumn BColumn C
Row 1DataData
Row 2DataData
Tip: To apply a table style in Word, select the table, go to Table Design tab, and choose from the Alterspective styles in the gallery.

Shape & Callout Styles

12 pre-built callout styles for highlighting important content.

Information Callouts

Info Box: Marine background with white text for important information.
Tip Box: Green background with white text for helpful suggestions.
Warning Box: Citrus background with Navy text for cautions.
Note Box: Pale Blue background with Navy text for general notes.

Accent Callouts

"Quote Box: Marine left border with italic serif text for pull quotes."
Highlight Box: Citrus left border for emphasised content.
Success Box: Green left border for positive outcomes.

Banners

Navy Banner - For major section breaks
Marine Banner - For subsection breaks

Additional Boxes

Sidebar: Pale Blue background with Marine border for supplementary content.
Accent Box: Marine top/bottom borders for subtle emphasis.
Definition Box: Navy left border for glossary terms and definitions.

PowerPoint Slide Layouts

9 professional slide layouts for branded presentations. Each layout is pre-configured with brand fonts, colours, and positioning.

Title Slide

Opening slide with A-pattern background on Marine. Title in Chronicle Display, subtitle in Montserrat.

Agenda

Numbered list layout for table of contents. Marine heading with Navy body text.

Section Divider

Full Marine background with white text. Use between major sections of your presentation.

Content

Standard title with bullet points. Most common layout for presenting information.

Two Column

Side-by-side content areas. Useful for comparisons or complementary information.

Title Only

Title with blank canvas below. Use for custom content, diagrams, or images.

Quote

Featured quote on Pale Blue background. Large Chronicle Display italic text with attribution.

Picture with Caption

Full-width image area with caption below. For showcasing visuals and graphics.

Blank

Empty slide for fully custom layouts. Add shapes, images, or text as needed.

Aspect Ratios

16:9 Widescreen Default aspect ratio for modern displays Default
4:3 Standard Traditional aspect ratio for older displays
Tip: Generate presentations with sample content using --with-sample-content to see all layouts in action.

Theme Colours (Shape Styles)

Word's built-in Shape Theme Styles are configured to use Alterspective brand colours. When you insert a shape and open the Shape Styles gallery, you'll see brand colours.

Brand Colour Palette

Navy
#17232D
Marine
#075156
Green
#2C8248
Citrus
#ABDD65
Pale Blue
#E5EEEF
Marine Tint
#5A8A8D

Theme Colour Mapping

The template configures Word's theme colours as follows:

Accent 1 Marine - primary accent
Accent 2 Navy - secondary accent
Accent 3 Green - success/growth
Accent 4 Citrus - highlight
Accent 5 Pale Blue - subtle
Accent 6 Marine Tint - softer accent
Important: Never use white text on Citrus (#ABDD65) - it fails WCAG accessibility standards. Use Navy or Marine text instead.

Command Line Interface

Use abt for interactive picking, direct document conversion, or template generation. The CLI now shares the same conversion workflow as the web API and MCP service.

ABT Pick

Arrow-key TUI with title preview, cover-page status, content snippet, and optional auto-open after generation.

Direct Convert

Convert straight to branded DOCX or PPTX when you already know the target file and output path.

Generate Templates

Produce blank, cover, or sample-rich templates for Word and PowerPoint with the current brand shell applied.

Installation

pip install alterspective-templates # Or install in development mode: pip install -e ".[dev]"

Interactive Picker

# Browse markdown files in the current directory abt pick # Start in another folder and choose both outputs abt pick --dir ./proposals --format both # Skip branded cover pages when generating Word abt pick --dir ./notes --format docx --no-cover-page # Add a logo for Word headers/covers and PowerPoint title slides abt pick --dir ./decks --logo ./assets/logo.png
TUI controls: Up/Down moves, Space toggles files, Enter confirms, a selects all, and q / Esc cancels. The preview panel shows the detected title, whether a cover page will be generated, and the first heading or paragraph from the highlighted markdown file.

Direct Conversion

# Convert markdown to branded Word alterspective-templates convert markdown input.md --output report.docx # Word conversion without a cover page alterspective-templates convert markdown input.md --output report.docx --no-cover-page # Convert markdown to branded PowerPoint alterspective-templates convert markdown-pptx input.md --output presentation.pptx # PowerPoint conversion in 4:3 with a title-slide logo alterspective-templates convert markdown-pptx input.md --output presentation.pptx --aspect-ratio 4:3 --logo ./assets/logo.png

Generate Word Templates

# Basic generation (creates .docx and .dotx with legal numbering) alterspective-templates generate word --output ./templates # Include sample content showing all styles alterspective-templates generate word --output ./templates --with-sample-content # Custom cover page alterspective-templates generate word --output ./templates \ --cover-title "Project Report" \ --cover-subtitle "Q1 2026 Analysis" \ --cover-variant dark # With logo and classification alterspective-templates generate word --output ./templates \ --logo ./assets/logo.png \ --classification "Confidential" # Disable legal-style numbering (enabled by default) alterspective-templates generate word --output ./templates --no-legal-numbering # A4 page size alterspective-templates generate word --output ./templates --page-size a4

Generate PowerPoint Presentations

# Basic generation (creates .pptx and .potx in 16:9) alterspective-templates generate powerpoint --output ./templates # Include sample content showing all layouts alterspective-templates generate powerpoint --output ./templates --with-sample-content # 4:3 aspect ratio alterspective-templates generate powerpoint --output ./templates --aspect-ratio 4:3

Useful Flags

pick --dir, -d Choose the directory scanned by the interactive picker.
pick --format, -f Preselect docx, pptx, or both.
pick --no-cover-page Disable branded Word cover-page generation inside the picker flow.
convert markdown --no-cover-page Skip the Word cover page even when a title is detected.
convert markdown-pptx --aspect-ratio Choose 16:9 or 4:3 for generated decks.
--logo Provide a brand logo for Word headers/covers and PowerPoint title slides.
generate word --no-legal-numbering Disable legal numbering; numbering is on by default for generated Word templates. Default: ON
--output, -o Choose the output directory for generated templates or converted documents.
--with-sample-content Include sample content demonstrating the current Word or PowerPoint layouts.
--prefix Change the generated filename prefix for template exports.
--aspect-ratio Slide dimensions: 16:9 (default) or 4:3 Default: 16:9

API Reference

REST endpoints for templates, style metadata, and markdown conversion. The web UI and these endpoints call the same shared conversion service used by the CLI and MCP tools.

Word conversion behaviour: a branded cover page is included by default when include_cover_page=true and a title can be detected from YAML frontmatter, the first H1, or top-of-file **Subject:** / **Title:** metadata lines.

Service Endpoints

GET /health Health check - returns service status
GET /ready Readiness check - verifies templates are available
GET /api/styles/word Word style definitions as JSON
GET /api/styles/powerpoint PowerPoint layout definitions as JSON
GET /api/templates/word/reference Download Word template (.docx)
GET /api/templates/powerpoint/reference Download PowerPoint template (.pptx)
GET /api/guidelines Brand guidelines summary as JSON

Template Variant Downloads

GET /api/templates/word/blank Blank Word template with styles only
GET /api/templates/word/cover Word template with branded cover page
GET /api/templates/word/full Word template with cover and sample content
GET /api/templates/powerpoint/blank Blank PowerPoint template
GET /api/templates/powerpoint/starter Starter deck with core layouts
GET /api/templates/powerpoint/full Full sample presentation with diagrams and icon references

Conversion Endpoints

POST /api/convert/markdown/word Multipart upload: file, optional include_cover_page, optional logo
POST /api/convert/markdown/powerpoint Multipart upload: file, optional aspect_ratio, optional logo

Conversion Examples

# Convert markdown to Word with default cover-page behaviour curl -X POST http://localhost:3402/api/convert/markdown/word \ -F "file=@proposal.md" \ -F "include_cover_page=true" \ -o proposal.docx # Convert markdown to PowerPoint in 4:3 curl -X POST http://localhost:3402/api/convert/markdown/powerpoint \ -F "file=@proposal.md" \ -F "aspect_ratio=4:3" \ -o proposal.pptx

Style Metadata

# Word styles curl http://localhost:3402/api/styles/word | jq # PowerPoint layouts curl http://localhost:3402/api/styles/powerpoint | jq # Download templates curl -o template.docx http://localhost:3402/api/templates/word/reference curl -o presentation.pptx http://localhost:3402/api/templates/powerpoint/reference

MCP Service

The MCP server exposes the same document conversion workflow to AI agents. Tool outputs return filenames plus base64-encoded document content rather than writing directly to disk.

This MCP is only for templates and document conversion. The separate general brand-guidance MCP remains at https://brand.alterspective.com.au/mcp, while this templates MCP is published at https://brand.alterspective.com.au/templates/mcp.

convert_markdown_to_word

Args: markdown_content, optional include_cover_page (default on), optional filename.

convert_markdown_to_powerpoint

Args: markdown_content, optional aspect_ratio (default 16:9), optional filename.

get_brand_styles

Returns the document-generation palette, typography, and usage rules used by this templates service.

Shared behaviour: Word cover pages, title detection, PowerPoint parsing, and brand defaults are shared with the CLI picker and the web conversion API.

Example MCP Tool Calls

{{ "tool": "convert_markdown_to_word", "arguments": {{ "markdown_content": "---\ntitle: Partnership Proposal\n---\n\n# Partnership Proposal\n\n## Overview\n- Point 1", "include_cover_page": true, "filename": "partnership-proposal.docx" }} }} {{ "tool": "convert_markdown_to_powerpoint", "arguments": {{ "markdown_content": "# Section One\n\n## Agenda\n- Item 1\n- Item 2", "aspect_ratio": "16:9", "filename": "agenda.pptx" }} }}

Response Shape

{{ "success": true, "filename": "partnership-proposal.docx", "content_base64": "...", "has_cover_page": true }}

Release Notes & Changelog

Recent delivery history for the service, documentation, and conversion workflow. The live service currently reports version 1.5.14.

v1.5.14

Converted the documentation jump menu into a compact sticky top reveal with current-section tracking and on-demand expansion.

v1.5.4

Refreshed the web documentation, release notes, and navigation so the UI matches the live CLI, API, MCP, Word, and PowerPoint workflows.

v1.5.3

Published release notes, aligned runtime version metadata, and fixed health/UI version reporting.

Documentation policy: release notes are published for shipped tags, and the changelog is kept in-repo so the web UI, production deployment, and repo history stay aligned.