Generation, conversion, API, and MCP workflows for branded Word and PowerPoint output.
Version 1.5.14
Complete branding solutions for Microsoft Word and PowerPoint. Pre-configured styles, theme colours, and typography ensure every document and presentation maintains consistent brand identity.
40+ styles, 3 table styles, 12 callout boxes, legal numbering, cover pages, headers/footers with logo and classification.
9 slide layouts, A-pattern title backgrounds, section dividers, quote slides, two-column layouts, and brand theme colours.
CLI, web API, and MCP now use the same conversion service, so defaults and branding stay aligned.
Cover pages and title slides can resolve from YAML frontmatter, the first H1, or `**Subject:**` / `**Title:**` lines.
Release notes, changelog entries, and the live health endpoint now track the shipped version together.
Follow these steps to start using Alterspective branded documents.
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".
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.
Open the template in Word, or if you installed the .dotx file, go to File > New > Personal and select "Alterspective-Template".
Use the Styles Gallery (Home tab) to apply branded styles. All Alterspective styles are visible in the Quick Styles gallery.
--no-legal-numbering when generating to disable it.
Choose the template variant that suits your needs.
Just styles configured. No cover page or sample content. Perfect for starting from scratch.
Includes branded cover page with A pattern. No sample content - ready for your document.
Cover page plus sample content demonstrating all styles, tables, and callouts.
Just slide layouts configured. No slides added. Start with a clean presentation.
Title slide, agenda, key insight, and basic slides. A quick-start foundation.
43 slides including icon library, diagrams, and example slides for all audiences.
Use the CLI to generate templates with custom options.
alterspective-templates generate word --output ./templates
alterspective-templates generate powerpoint --output ./templates
Full brand guidelines including colours, typography, and logo usage.
Convert your markdown documents to branded Word or PowerPoint files. Upload a .md file and download the converted document with full Alterspective branding applied.
Convert markdown to a branded Word document with theme colours, headers, footers, and cover-page support.
**Subject:** / **Title:**.Convert markdown to a branded presentation with title slides, section dividers, content, quotes, tables, and diagrams.
# 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 coversAll styles available in the Alterspective Word Template, organised by category.
Three branded table styles with professional formatting.
Navy header with white text, alternating Pale Blue rows. The default table style.
| Column A | Column B | Column C |
|---|---|---|
| Row 1 | Data | Data |
| Row 2 | Data | Data |
| Row 3 | Data | Data |
Marine header with white text, alternating Pale Blue rows.
| Column A | Column B | Column C |
|---|---|---|
| Row 1 | Data | Data |
| Row 2 | Data | Data |
Marine header, subtle borders, clean appearance for minimal designs.
| Column A | Column B | Column C |
|---|---|---|
| Row 1 | Data | Data |
| Row 2 | Data | Data |
12 pre-built callout styles for highlighting important content.
9 professional slide layouts for branded presentations. Each layout is pre-configured with brand fonts, colours, and positioning.
Opening slide with A-pattern background on Marine. Title in Chronicle Display, subtitle in Montserrat.
Numbered list layout for table of contents. Marine heading with Navy body text.
Full Marine background with white text. Use between major sections of your presentation.
Standard title with bullet points. Most common layout for presenting information.
Side-by-side content areas. Useful for comparisons or complementary information.
Title with blank canvas below. Use for custom content, diagrams, or images.
Featured quote on Pale Blue background. Large Chronicle Display italic text with attribution.
Full-width image area with caption below. For showcasing visuals and graphics.
Empty slide for fully custom layouts. Add shapes, images, or text as needed.
--with-sample-content to see all layouts in action.
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.
The template configures Word's theme colours as follows:
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.
Arrow-key TUI with title preview, cover-page status, content snippet, and optional auto-open after generation.
Convert straight to branded DOCX or PPTX when you already know the target file and output path.
Produce blank, cover, or sample-rich templates for Word and PowerPoint with the current brand shell applied.
pip install alterspective-templates
# Or install in development mode:
pip install -e ".[dev]"
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
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.
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
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
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
docx, pptx, or both.16:9 or 4:3 for generated decks.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.
include_cover_page=true and a title can be detected from YAML frontmatter, the
first H1, or top-of-file **Subject:** / **Title:** metadata lines.
# 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
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
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.
Args: markdown_content, optional include_cover_page (default on), optional filename.
Args: markdown_content, optional aspect_ratio (default 16:9), optional filename.
Returns the document-generation palette, typography, and usage rules used by this templates service.
{{
"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"
}}
}}
{{
"success": true,
"filename": "partnership-proposal.docx",
"content_base64": "...",
"has_cover_page": true
}}
Recent delivery history for the service, documentation, and conversion workflow.
The live service currently reports version 1.5.14.
Converted the documentation jump menu into a compact sticky top reveal with current-section tracking and on-demand expansion.
Refreshed the web documentation, release notes, and navigation so the UI matches the live CLI, API, MCP, Word, and PowerPoint workflows.
Published release notes, aligned runtime version metadata, and fixed health/UI version reporting.