# Carbone > Carbone is an efficient, no-code, universal document generation and conversion engine and API. It merges JSON data with a template designed in your usual editor (Word, Excel, PowerPoint, LibreOffice, Google Docs, OnlyOffice, HTML, or Markdown) and renders the result in 100+ output formats. Design is separated from data, so non-developers can author templates and automate workflows while developers and AI assistants integrate programmatically. Output is deterministic: the same template plus the same data always yields the same document. Documentation is currently English-only. Key facts: - Input template formats: PDF, DOCX, XLSX, PPTX, ODT, ODS, ODP, ODG, XML, HTML, Markdown, SVG, IDML - Output formats: 100+ total, including PDF, DOCX, XLSX, PPTX, ODT, ODS, ODP, CSV, HTML, Markdown, TXT, XML, IDML, JPG, PNG, EPUB - Template editors: design in LibreOffice, Microsoft Word / Excel / PowerPoint, Google Docs, Apple Pages, or OnlyOffice — no proprietary editor and no code-only template syntax - AI integration: install the Carbone Skill to teach the templating language to any assistant that supports the open Agent Skills standard (https://agentskills.io), or wire the Carbone MCP server into any MCP client to expose Carbone's full API. See the "AI integration" section below for details and the supported tools. - Rich content inside templates: dynamic charts, tables, barcodes, QR codes, images, colors, inline SVGs, hyperlinks, HTML from WYSIWYG editors, conditional rendering, loops, and chainable formatters - Tag syntax: `{d.field}` data, `{c.field}` complement, `{#alias}`/`{$alias}` aliases, `{t(key)}` i18n, `{o.option}` options; formatters chain with `:` - Multilingual rendering with locale-aware numbers, dates, times, and currency formats - Batch generation of hundreds of documents per request, with template versioning via `deployedAt` timestamps - E-signature workflows: render the document with Carbone, then hand off to a signature provider for the signature step (see the Integrations section below for the supported providers) - PDF utilities: merge multiple PDFs into a single document, convert HTML to PDF (drop-in alternative to Gotenberg or Puppeteer), convert Markdown to PDF, convert Office documents to PDF - Deployment options: - Carbone Cloud — managed REST API, EU-hosted in Paris - Carbone On-Premise — self-hosted via the Docker image `carbone/carbone-ee` or via native server binaries for Linux, macOS, and Windows (all binary downloads listed on the Carbone changelog page, https://carbone.io/changelog.md) - Carbone On-AWS — turnkey AWS deployment, all Enterprise features enabled by default - Embedded Carbone JS — open-source Node.js library - Licensing for self-hosted deployments: - Both the Docker image and the OS binaries start for free with no license, granting access to all Community features - Providing an Enterprise license unlocks all features (advanced features, batch generation, conversion engines, support) - Carbone On-AWS includes the Enterprise license by default - For an Enterprise license, contact the Carbone commercial team at contact@carbone.io - Support: support@carbone.io — answered directly by Carbone's engineers and founders, not by bots or an outsourced helpdesk, so questions and bug reports get a real human reply quickly ## Root URL - https://account.carbone.io - Carbone Cloud account and API key management - https://api.carbone.io - REST API base URL (Carbone Cloud) - https://studio.carbone.io - Carbone Studio (template designer) - https://mcp.carbone.io - Hosted Carbone MCP server - https://hub.docker.com/r/carbone/carbone-ee - Docker Hub image for self-hosting the Carbone Server API (On-Premise) - https://github.com/carboneio - Open-source repositories (core engine, MCP, Skill, SDKs, integrations, examples) - https://carbone.io/llms-full.txt - Full content of this index, with each page inlined ## AI integration Two independent layers, useful alone or together. - **Carbone Skill — knowledge layer.** Teaches the templating language (tags, formatters, loops, conditions, `:set`, HTML and Markdown). Available for any assistant that supports the open Agent Skills standard (https://agentskills.io): Claude (Desktop, Code, claude.ai), ChatGPT, Google Gemini, Microsoft Copilot, Cursor, OpenAI Apps SDK. [Docs](https://carbone.io/documentation/developer/ai/skills.md). - **Carbone MCP server — action layer.** Official Model Context Protocol server exposing Carbone's full API. Hosted at https://mcp.carbone.io, or self-hosted via the npm `carbone-mcp` package (stdio) or Docker (HTTP). Tools: render_document, convert_document, upload_template, list_templates, download_template, update_template_metadata, delete_template, list_categories, list_tags, get_api_status, get_capabilities. Compatible with Claude Desktop, Claude Code, Cursor, VS Code, Microsoft Copilot Studio, Mistral Vibe, and any MCP-aware agent. [Docs](https://carbone.io/documentation/developer/ai/mcp.md). ## Integrations at a glance - AI assistants: Claude, ChatGPT, Google Gemini, Microsoft Copilot, Meta Llama, DeepSeek, Mistral Vibe (formerly Le Chat) - Automation / no-code: n8n, Make (Integromat), Zapier, Glide, Retool, Ninox - CRM & business apps: Salesforce, HubSpot, Pipedrive, Odoo (official `report_carbone` module, AGPL-3, for Odoo 18.0 and 19.0) - Electronic signature: DocuSign, Subnoto, Yousign, Docuseal, Documenso, SignWell - Languages & SDKs: Node.js, JavaScript, Python, PHP, Go, Java - Infrastructure: Docker (Carbone Server API self-hosted), Amazon Web Services ## Getting Started - [Generate a document](https://carbone.io/documentation/quickstart/getting-started/generate-a-document.md) - Generate your first report in just a few minutes with Carbone! - [For Developers](https://carbone.io/documentation/quickstart/integration/for-developers.md) - Add document generation into your application - [For NoCode makers](https://carbone.io/documentation/quickstart/integration/for-nocode-makers.md) - Add document generation into your environment - [For DevOps](https://carbone.io/documentation/quickstart/integration/for-devops.md) - Add document generation to your environment ## Template Design - [Getting started](https://carbone.io/documentation/design/overview/getting-started.md) - Design your first template - [Template feature](https://carbone.io/documentation/design/overview/template-feature.md) - Supported template files and features - [Version lifecycle](https://carbone.io/documentation/design/overview/version-lifecycle.md) - Learn how to upgrade and explore the features and versions of Carbone - [Design best practices](https://carbone.io/documentation/design/overview/design-best-practices.md) - Configuration of your tools and frequently asked questions - [Fonts support](https://carbone.io/documentation/design/overview/font-support.md) - List of supported font by Carbone - [Philosophy](https://carbone.io/documentation/design/overview/philosophy.md) - Understand the Unique and Universal Carbone templating language - [The basics](https://carbone.io/documentation/design/substitutions/the-basics.md) - Learn how to use a simple Carbone placeholder tag - [Array search](https://carbone.io/documentation/design/substitutions/array-search.md) - Search an item within an array without doing a loop - [Aliases](https://carbone.io/documentation/design/substitutions/aliases.md) - Simplify Carbone tag with aliases - [Loop over array](https://carbone.io/documentation/design/repetitions/with-arrays.md) - Repeat any part of you document - [Loop over object properties](https://carbone.io/documentation/design/repetitions/with-objects.md) - Repeat any part of you document from object properties - [Sorting arrays](https://carbone.io/documentation/design/repetitions/sorting.md) - Sort your data - [Filtering arrays](https://carbone.io/documentation/design/repetitions/filtering.md) - Filter your array - [Grouping](https://carbone.io/documentation/design/repetitions/grouping.md) - Group by any item of your data or change the orginal structure of the JSON data source - [Distinct](https://carbone.io/documentation/design/repetitions/distinct.md) - Print only distinct value - [Lookup](https://carbone.io/documentation/design/repetitions/lookup.md) - Find a value in a list or dictionary using a search filter - [Overview](https://carbone.io/documentation/design/formatters/overview.md) - Translate raw data into human readable text. - [Text Formatting](https://carbone.io/documentation/design/formatters/text.md) - List of function to manipulate and transform your JSON strings - [Number Formatting](https://carbone.io/documentation/design/formatters/number.md) - List of function to manipulate and transform your JSON numbers - [Currency Formatting](https://carbone.io/documentation/design/formatters/currency.md) - List of function to manipulate and transform your JSON prices - [Date Formatting](https://carbone.io/documentation/design/formatters/date.md) - List of function to format your JSON dates - [Interval and Duration](https://carbone.io/documentation/design/formatters/interval.md) - List of function to manipulate and transform your JSON dates - [Array manipulation](https://carbone.io/documentation/design/formatters/array.md) - List of function to manipulate and transform your JSON arrays - [Conditions](https://carbone.io/documentation/design/conditions/overview.md) - How to add conditions to your templates? - [Inline Conditions](https://carbone.io/documentation/design/conditions/inline-conditions.md) - How to conditionally print a text? - [Conditional blocks](https://carbone.io/documentation/design/conditions/conditional-blocks.md) - How to hide or show a part of your document? - [Smart conditional blocks](https://carbone.io/documentation/design/conditions/smart-conditions.md) - Show or hide an entire table, paragraph, ..., row, column with one simple Carbone tag - [Simple Mathematics](https://carbone.io/documentation/design/computation/simple-mathematics.md) - Simple addition, substraction, multiplications, division - [Aggregators](https://carbone.io/documentation/design/computation/aggregation.md) - How to perform calculations on array data? - [Store and transform](https://carbone.io/documentation/design/computation/store-and-transform.md) - Store, modify, and transform JSON to simplify your templates - [Pagination](https://carbone.io/documentation/design/advanced-features/pagination.md) - How to set page numbers, table of contents, bookmarks, and repeat table header - [Pictures](https://carbone.io/documentation/design/advanced-features/pictures.md) - How to integrate dynamic pictures in your template? - [Colors](https://carbone.io/documentation/design/advanced-features/colors.md) - Applying dynamic colors to elements (text, row, cell, ...) - [HTML](https://carbone.io/documentation/design/advanced-features/html.md) - HTML Rendering for Documents: Transforming WYSIWYG and AI-Generated HTML into ODT, DOCX, and PDF. - [Charts](https://carbone.io/documentation/design/advanced-features/charts.md) - How to create charts in documents - [Barcode](https://carbone.io/documentation/design/advanced-features/barcode.md) - How to integrate barcode in your template? - [Hyperlinks](https://carbone.io/documentation/design/advanced-features/hyperlinks.md) - A Step-by-Step Guide to Embedding Hyperlinks in Your Documents - [Forms](https://carbone.io/documentation/design/advanced-features/forms.md) - How to include dynamic forms fields in your document? - [Translations i18n](https://carbone.io/documentation/design/advanced-features/translations-i18n.md) - How to translate text in your template? - [Key-value mapping](https://carbone.io/documentation/design/advanced-features/key-value-mapping.md) - Translate values in JSON to human-readable text using a provided enum key-value map - [Transform](https://carbone.io/documentation/design/advanced-features/transform.md) - Move items in a page on X or Y axis - [File operations](https://carbone.io/documentation/design/advanced-features/file-operations.md) - Append, merge or attach files in the generated document - [Digital signatures](https://carbone.io/documentation/design/advanced-features/signatures.md) - [BETA] Integrate electronic signatures into your documents - [HTML templates](https://carbone.io/documentation/design/template-formats/html.md) - Generate pixel-perfect PDFs from HTML and CSS templates with built-in dynamic data injection, loops, conditions, charts, barcodes, and custom headers/footers. Ideal for invoices, reports, certificates, and contracts. - [Markdown templates](https://carbone.io/documentation/design/template-formats/markdown.md) - Learn how to use Markdown as a template format in Carbone to generate PDF, DOCX, ODT, PNG, and JPG files with dynamic data injection, loops, and conditional content. ## Developer & API ### AI integration (MCP & Skill) - [MCP](https://carbone.io/documentation/developer/ai/mcp.md) - Connect Claude, ChatGPT, and other AI assistants to Carbone using Model Context Protocol - [Carbone Skill](https://carbone.io/documentation/developer/ai/skills.md) - Accurate Carbone tag syntax, formatters, and best practices for AI assistants ### HTTP API - [Introduction](https://carbone.io/documentation/developer/http-api/introduction.md) - Getting started with Carbone Cloud / On-Premise HTTP API - [Generate reports](https://carbone.io/documentation/developer/http-api/generate-reports.md) - HTTP API to merge the data in your template - [Convert Documents](https://carbone.io/documentation/developer/http-api/convert-reports.md) - HTTP API to convert documents between 100+ formats in a single API call - [Download Generated Reports](https://carbone.io/documentation/developer/http-api/download-reports.md) - Download Report | Get your awesome documents with this simple HTTP API - [Upload and manage templates](https://carbone.io/documentation/developer/http-api/manage-templates.md) - Manage templates | Get your awesome documents with this simple HTTP API ### SDKs - [NodeJS SDK](https://carbone.io/documentation/developer/api-sdks/nodejs.md) - Generate report with NodeJS - [Javascript SDK](https://carbone.io/documentation/developer/api-sdks/javascript.md) - Generate report with Javascript in your browser - [Go SDK](https://carbone.io/documentation/developer/api-sdks/go.md) - Generate report with Go - [PHP SDK](https://carbone.io/documentation/developer/api-sdks/php.md) - Generate report with PHP - [Python SDK](https://carbone.io/documentation/developer/api-sdks/python.md) - Generate report with Python - [Rust SDK](https://carbone.io/documentation/developer/api-sdks/rust.md) - Generate report with Rust - [Java SDK](https://carbone.io/documentation/developer/api-sdks/java.md) - Generate report with java ### On-Premise installation - [On-Premise](https://carbone.io/documentation/developer/on-premise-installation/introduction.md) - Run Carbone from your environment - Introduction to Carbone On-Premise setup - [On-Premise Requirements](https://carbone.io/documentation/developer/on-premise-installation/requirements.md) - Learn how to configure your On-Premise installation - [Configuration parameters](https://carbone.io/documentation/developer/on-premise-installation/configuration.md) - Carbone On-Premise configuration options reference - [Deploy on Linux](https://carbone.io/documentation/developer/on-premise-installation/install-on-linux.md) - Learn how to install on Linux manually - [Deploy on MacOS](https://carbone.io/documentation/developer/on-premise-installation/install-on-macos.md) - Learn how to install on MacOS manually - [Deploy on Windows](https://carbone.io/documentation/developer/on-premise-installation/install-on-windows.md) - Learn how to install on Windows manually - [Upgrade Guide](https://carbone.io/documentation/developer/on-premise-installation/upgrade-guide.md) - How to Upgrade Between Versions - [On-Premise plugins](https://carbone.io/documentation/developer/on-premise-installation/plugins.md) - Add plugins in your On-Premise installation - [Customize Carbone Docker](https://carbone.io/documentation/developer/on-premise-installation/container-customization.md) - Create your own Carbone container ### Self-hosted deployment - [Deploy with Docker](https://carbone.io/documentation/developer/self-hosted-deployment/deploy-with-docker.md) - Deploy Carbone on your server with docker - [Deploy on AWS](https://carbone.io/documentation/developer/self-hosted-deployment/deploy-on-aws.md) - Generate and manage your reports inside your own AWS infrastructure. - [Carbone on Amazon Elastic Container Service](https://carbone.io/documentation/developer/self-hosted-deployment/deploy-on-aws-ecs.md) - Generate and manage your reports inside your own Amazon ECS Cluster - [Deploy on Google Cloud Platform](https://carbone.io/documentation/developer/self-hosted-deployment/deploy-on-gcp.md) - Generate and manage your reports inside your own Google Cloud Platform infrastructure. - [Deploy on Azure](https://carbone.io/documentation/developer/self-hosted-deployment/deploy-on-azure.md) - Generate and manage your reports inside your own Azure environnement using Container Apps - [Deploy on Kubernetes](https://carbone.io/documentation/developer/self-hosted-deployment/deploy-on-kubernetes.md) - Run you own Carbone instance in your Kubertnetes cluster ### Embedding - [Studio Web Component](https://carbone.io/documentation/developer/embedding/studio-web-component.md) - Embed the Carbone Studio in your application - [Embedding in Node.js](https://carbone.io/documentation/developer/embedding/embedding-in-node.md) - Embed Carbone in your NodeJS application - [Multi-Tenancy](https://carbone.io/documentation/developer/embedding/multi-tenancy.md) - How to enable multi-tenancy for On-Premise installation or embedded studio ### Under the hood - [Overview](https://carbone.io/documentation/developer/under-the-hood/overview.md) - How Carbone works and how the magic happens - [Architecture guideline](https://carbone.io/documentation/developer/under-the-hood/architecture-guideline.md) - The answer to all your questions for the best implementation of Carbone ## Integrations - [All integrations](https://carbone.io/integration/index.md) - Browse every Carbone integration (AI assistants, no-code, SDKs, business apps) ### AI Assistants - [ChatGPT](https://carbone.io/integration/chatgpt.md) - Generate Branded Documents from ChatGPT, Custom GPTs, and the Apps SDK - [Claude](https://carbone.io/integration/claude.md) - Generate Documents from Claude with the Carbone Skill and MCP - [Microsoft Copilot](https://carbone.io/integration/copilot.md) - Carbone MCP on the Azure MCP Center, wire branded document generation into every Copilot - [DeepSeek](https://carbone.io/integration/deepseek.md) - The Document Export Layer for DeepSeek, OpenAI-Compatible, Sovereign-Ready - [Gemini](https://carbone.io/integration/gemini.md) - Give Gemini Your Branded Templates, Beyond Generic PDF Generation - [Llama](https://carbone.io/integration/llama.md) - Self-hosted document generation with Meta Llama and Carbone, never leaves your servers - [Vibe](https://carbone.io/integration/vibe.md) - Generate Documents from Vibe (formerly Le Chat) with the Carbone MCP Connector ### Automation - [Unlock the Power of Glide: Generate Effortless PDFs Now!](https://carbone.io/integration/glide.md) - Glide is a handy NoCode tool for creating business applications quickly. Using Carbone with Glide, you can format your data to produce superb documents, reports and PDFs. - [Make](https://carbone.io/integration/make.md) - Build and automate anything with Make and Carbone - [N8N](https://carbone.io/integration/n8n.md) - Official Carbone Node to Automate Reporting - [Ninox](https://carbone.io/integration/ninox.md) - Seamless integration between Carbone and Ninox - [Retool](https://carbone.io/integration/retool.md) - Document generation using Carbone in Retool application - [Zapier](https://carbone.io/integration/zapier.md) - Easy report automation for busy people ### CRM & Marketing - [Hubspot](https://carbone.io/integration/hubspot.md) - Generate PDF, reports and documents from your Hubspot events and datas - [Odoo](https://carbone.io/integration/odoo.md) - Official Plugin to generate reports from Odoo Data - [Pipedrive](https://carbone.io/integration/pipedrive.md) - Generate PDF, reports and documents from your Pipedrive events and datas - [Salesforce](https://carbone.io/integration/salesforce.md) - Advanced reporting with your Salesforce datas ### Signature - [Docusign](https://carbone.io/integration/docusign.md) - Automate document generation and signature with Docusign - [Subnoto](https://carbone.io/integration/subnoto.md) - Generate contracts with Carbone, sign them confidentially with Subnoto ### Technology - [Amazon Web Services](https://carbone.io/integration/aws.md) - Run Carbone in your AWS environnement - [Docker](https://carbone.io/integration/docker.md) - Setup and run Carbone in your docker environement - [Golang](https://carbone.io/integration/golang.md) - Generate PDF documents using Golang with Carbone - [Java](https://carbone.io/integration/java.md) - Generate PDF, reports and documents in Java with Carbone - [Generate documents from JavaScript code](https://carbone.io/integration/javascript.md) - Generate advanced reports, rich documents and PDFs from your JavaScript application. Carbone is the best JavaScript PDF solution. - [NodeJS](https://carbone.io/integration/nodejs.md) - Generate PDF files using NodeJS with Carbone - [PHP](https://carbone.io/integration/php.md) - Generate PDF, reports and documents from your PHP code with Carbone - [Python](https://carbone.io/integration/python.md) - Generate PDF, reports and documents from your Python code with Carbone ## Examples - [Examples gallery](https://carbone.io/examples/index.md) - Real document examples generated by Carbone, with template + data + result - [Best Selling Vehicles Awards](https://carbone.io/examples/awards-simple/index.md) - Create Professional Award Documents with Carbone - [Invoice Automation](https://carbone.io/examples/invoice-expert/index.md) - Generate PDF Invoices with Carbone - [Financial report](https://carbone.io/examples/financial-report/index.md) - Generate Financial report with Carbone - [Sensor readings](https://carbone.io/examples/sensor-readings/index.md) - Create stunning reports for your industrial temperature sensors - [E-ticket](https://carbone.io/examples/ticket/index.md) - Generate your tickets with Carbone - [Menu](https://carbone.io/examples/menu/index.md) - Generate Professional Restaurant Menus with Carbone - [Real estate property document](https://carbone.io/examples/real-estate-property-description/index.md) - Automate Real estate documents creation - [Summary](https://carbone.io/examples/summary/index.md) - Generate Professional Summary with Carbone - [EditorJS to DOCX/PDF](https://carbone.io/examples/editorjs/index.md) - Convert EditorJS Content from HTML WYSIWYG Tool to PDF Documents - [Store Inventory](https://carbone.io/examples/shoes/index.md) - Present your inventory - [Bank statement](https://carbone.io/examples/bank-statement-simple/index.md) - Generate a simple bank statement with Carbone - [Dynamic pins on a map](https://carbone.io/examples/dynamic-pins-on-map/index.md) - Generate a map with dynamic pins with Carbone - [Gallery of images](https://carbone.io/examples/gallery-simple/index.md) - Generate a beautiful gallery of images with Carbone - [Bank statement](https://carbone.io/examples/bank-statement-expert/index.md) - Generate a complete bank statement with Carbone - [Satisfaction Report](https://carbone.io/examples/bargraph/index.md) - Generate Customer Satisfaction Reports with Carbone - [Training Certificate](https://carbone.io/examples/certificat/index.md) - Generate Professional Training Certificates with Carbone - [Vehicle inspection report](https://carbone.io/examples/check-out/index.md) - Generate a stunning report including images with Carbone - [Best Manufacturer Awards](https://carbone.io/examples/classification-simple/index.md) - Streamline your document creation process with Carbone - [E-ticket](https://carbone.io/examples/eticket/index.md) - Generate your tickets with Carbone - [Invoice Automation / Factur-X](https://carbone.io/examples/factur-x/index.md) - Generate PDF Invoices with Carbone - [Simple Invoice Automation](https://carbone.io/examples/invoice-simple/index.md) - Generate PDF Invoices with Carbone - [Barcodes On Labels](https://carbone.io/examples/label-barcode/index.md) - Generate stunning labels effortlessly with Carbone - [Grid layout in a presentation](https://carbone.io/examples/matrix-pptx/index.md) - Generate stunning slides effortlessly with Carbone - [Mission Report](https://carbone.io/examples/mission-report/index.md) - Create Professional Mission Reports with Carbone - [PDF Forms](https://carbone.io/examples/pdf-form/index.md) - Generate Professional PDF Forms with Carbone - [PDF Forms with Background Images](https://carbone.io/examples/pdf-forms-bg/index.md) - Generate Professional PDF Forms with Carbone - [Planning with subtotals](https://carbone.io/examples/planification-medium/index.md) - Share your planning with Carbone - [Planning](https://carbone.io/examples/planification-simple/index.md) - Create Professional Project Planning Documents with Carbone - [Prescription](https://carbone.io/examples/prescription/index.md) - Generate Professional Medical Prescriptions with Carbone - [Product Comparison Table](https://carbone.io/examples/product-comparison-table/index.md) - Generate product comparison - [Automation of Quotes](https://carbone.io/examples/quote-with-datasheet/index.md) - Generate PDF Quotations including datasheet with Carbone - [Stock inventory spreadsheet](https://carbone.io/examples/stock-inventory-spreadsheet/index.md) - Create stunning reports for your stock inventory ## Features - [Designer Assistant](https://carbone.io/features/carbone-studio.md) - Carbone is more than just a simple document generator. Use our Studio to seamlessly guide you through report design and preview, making the process intuitive and efficient. - [Document converter](https://carbone.io/features/document-converter.md) - Effortlessly convert your documents into over 160 formats with Carbone's automated management of multiple document converters. - [Universal Template](https://carbone.io/features/universal-template.md) - Insert tags using curly braces like {} into virtually any document (DOCX, ODT, ODS, XLSX, XML, MD, HTML, ...) and Carbone will replace those placeholders with data from your application or database. ## Reference - [Blog](https://carbone.io/blog/) - Tutorials, product news, and document-automation guides - [Pricing](https://carbone.io/pricing.md) - Carbone Cloud and on-premise plans - [Changelog](https://carbone.io/changelog.md) - Version history and release notes - [About Carbone](https://carbone.io/about-us.md) - Company, values, and team