The Width Problem in Markdown PDF Exports
Technical documentation regularly contains wide artifacts: multi-actor sequence diagrams, project timelines rendered as Gantt charts, pipeline flowcharts with many parallel branches. These diagrams are authored in Mermaid because the plain-text format lives naturally alongside the prose in the same Markdown file.
When that document needs to be shared as a PDF, standard export tools face a fundamental constraint: they apply a fixed portrait page width. A diagram designed to span a wide canvas gets clipped at the right edge of the page, often losing the most downstream steps or the final column of a matrix. Recipients receive an incomplete picture.
Workarounds are tedious. Exporting the diagram separately as an image, resizing it, inserting it as an inline PNG, then regenerating the document adds many manual steps every time the source Markdown changes. For living documentation that is updated frequently, this workflow is not sustainable.
Related: Best Mac Viewer for Advanced Markdown with Mermaid Diagrams — how Telescopo renders the Mermaid diagrams that drive the need for landscape export.
Telescopo's Landscape PDF Export
Telescopo provides a PDF export option that includes landscape page orientation. Selecting it before export rotates the page to its wider dimension, giving your Mermaid diagrams the full horizontal space they were designed to occupy. No diagram truncation, no manual image substitution, and no post-processing.
The export renders the same view you see on screen, including all Mermaid diagrams, all typeset LaTeX equations, all code blocks with syntax highlighting, and all prose. What you see in Telescopo is exactly what appears in the PDF.
Theme-Aware: Preserving Your Visual Style
Many documentation teams work in dark mode and share dark-themed documents internally. Standard macOS print dialogs typically force white backgrounds regardless of your app's theme, which breaks the visual consistency of the document.
Telescopo's export preserves your selected theme. If you are working in the Dark theme or the Cyberpunk theme, the PDF reflects those colors. Background, text color, syntax highlighting token colors, diagram stroke colors, and border styles all carry through from the on-screen preview to the exported file. The recipient sees exactly the same document you composed.
Related: Dark Mode and Custom Themes for Reading Code and Markdown on Mac — details on all six themes that are preserved in PDF export.
LaTeX Math in PDF Exports
LaTeX equations embedded in your Markdown are rendered at full resolution in the exported PDF. Both inline expressions and display-mode blocks are typeset with the same local rendering engine used for the on-screen preview. The result is mathematically precise typography, identical in quality to what a dedicated LaTeX compiler produces, embedded seamlessly within your prose without any additional tools.
Related: How to View Markdown with Inline LaTeX Mathematics on macOS — full details on Telescopo's local LaTeX rendering engine.
Who This Solves Problems For
Technical Writers
Producing API documentation or system architecture guides that include multiple Mermaid diagrams and need to be delivered as polished PDFs to non-technical stakeholders.
Engineering Leads
Sharing design proposals that combine sequence diagrams, architectural flowcharts, and decision text in a single readable document without manually assembling a slide deck.
Researchers
Exporting manuscript drafts that mix LaTeX equations with explanatory diagrams into shareable PDF proofs without running a full LaTeX compiler toolchain.
Project Managers
Distributing Gantt-chart-driven Markdown sprint plans as clean PDFs to stakeholders who do not have a Markdown viewer installed.
Frequently Asked Questions
Can Telescopo export Markdown with Mermaid diagrams to PDF on Mac?
Yes. Telescopo exports fully rendered Markdown, including all embedded Mermaid diagrams and LaTeX math, to a high-quality PDF file on macOS.
Does Telescopo support landscape PDF export for wide diagrams?
Yes. Telescopo supports landscape PDF export so that wide Mermaid flowcharts and Gantt charts are not clipped at the right margin.
Are themes preserved when exporting Markdown to PDF in Telescopo?
Yes. Telescopo preserves your selected visual theme in the exported PDF, including background color, syntax highlighting colors, and overall typography.
