Markdown++.

Open. Structured. AI-Ready.

Markdown++ combines the simplicity of standard Markdown with the capabilities required for professional technical documentation.

Enhancements such as conditional content, variables, reusable includes, structured cross-references, and publishing metadata remain invisible to standard Markdown editors and viewers. Your files stay fully compatible with CommonMark while gaining the power needed for enterprise publishing and AI-ready documentation.

As an open specification released under the MIT License, Markdown++ protects your content investment and keeps your documentation free from proprietary lock-in.

Professional Documentation Without Vendor Lock-In

Markdown++ combines the simplicity of human-readable text files with the capabilities of professional publishing workflows—for web, print, automation, and AI-ready knowledge.

Business Value

Your Content Remains Yours

Your documentation stays open, readable, and version-controlled. Because Markdown++ is based on the CommonMark standard, your content remains accessible beyond any single authoring or publishing tool.

  • Human-readable, plain-text source files
  • Fully compatible with Git and modern version control systems
  • Easy to review, compare, and maintain
  • No proprietary file formats or vendor lock-in
  • Future-ready for publishing and AI-powered applications

Better Collaboration

Markdown++ fits naturally into modern documentation workflows, enabling technical writers, developers, and product experts to collaborate using familiar Git-based review and approval processes.

  • Work seamlessly with Git and modern version control
  • Simplify reviews with plain-text files
  • Enable efficient collaboration across documentation and development teams
  • Integrate documentation into existing engineering workflows

Built for Automation

Text-based source files integrate easily into modern build, release, and DevOps environments.

  • Support automated publishing workflows
  • Integrate with CI/CD pipelines
  • Enable repeatable, reliable documentation builds
  • Streamline release and deployment processes

Built for AI-Ready Documentation

Structured content and preserved semantic information provide an ideal foundation for AI-powered documentation.

Markdown++ helps generate high-quality AI-ready Knowledge Files for the WebWorks Platform, enterprise RAG solutions, and other AI applications. It also provides a practical migration path from proprietary and binary document formats to an open, future-ready documentation standard.

Markdown++ Compared to DITA and DocBook.

Markdown++ provides many of the structured authoring capabilities found in DITA and DocBook—without requiring authors to create or maintain XML.

By combining the simplicity of Markdown with advanced features such as conditional content, variables, reusable includes, structured cross-references, and publishing metadata, Markdown++ enables professional technical documentation in a format that is easy to read, write, and maintain.

For many documentation projects, Markdown++ offers a practical, lightweight alternative to XML-based authoring while preserving the structure needed for professional publishing and AI-ready documentation.


Meet Your Team Where They Are.

Markdown++ is designed to fit naturally into your existing documentation workflow.

Existing WebWorks ePublisher users can adopt Markdown++ without changing their publishing pipeline—making it easy to modernize content while protecting existing investments.

From Microsoft Word

Move beyond binary document formats while keeping the authoring experience familiar.

Markdown++ enables:

  • Git-friendly, text-based source files
  • Meaningful version control with readable diffs
  • Pull-request reviews for documentation changes
  • Automatic preservation of custom paragraph and character styles using <!--style:--> directives

From Adobe FrameMaker

Transition existing FrameMaker projects without rebuilding your documentation.

Markdown++ preserves the structure and intelligence of your content, including:

  • Direct conversion of FrameMaker .book files into Markdown++ book assemblies using <!--include:--> directives
  • Conditional content
  • Variables
  • Cross-references
  • Index markers
  • Existing publishing workflows

From DITA XML

Modernize your DITA content without losing the benefits of structured authoring.

Markdown++ preserves the capabilities that make DITA valuable while replacing XML complexity with a clean, human-readable Markdown format.

Key capabilities include:

  • DITA maps converted into Markdown++ book structures
  • DITA topics converted into standard .md files
  • Topic-based authoring
  • Content reuse
  • Conditional content
  • Metadata preservation
  • Multi-format publishing

All while eliminating the complexity of XML authoring.

From AsciiDoc, MDX, and reStructuredText

Markdown++ provides practical migration paths from other lightweight markup languages.

  • AsciiDoc content can be integrated through the open-source quadralay/asciidoctor-mdpp bridge, which generates valid Markdown++.
  • MDX and reStructuredText (reST) content can be migrated to standards-based CommonMark-compatible Markdown++, simplifying authoring and publishing workflows.

The result is documentation that:

  • Remains fully compatible with standard Markdown tools
  • Eliminates dependencies on JSX and custom block syntax
  • Reduces build complexity for preview and publishing
  • Provides a consistent, AI-ready documentation source

Ideal For

Markdown++ is an excellent choice for organizations that want to modernize their documentation without sacrificing openness, structure, or publishing flexibility.

  • Software development and developer documentation teams
  • Docs-as-Code environments
  • Organizations using Git-based documentation workflows
  • Technical documentation teams modernizing from Microsoft Word or Adobe FrameMaker
  • Companies looking to eliminate vendor lock-in with an open documentation standard
  • Organizations preparing structured documentation for AI-powered applications and intelligent knowledge systems

AI-Ready Documentation. End to End.

From your source content through automated publishing to cloud-hosted AI Assistants, every component works together seamlessly—helping you deliver trusted information wherever your users need it.


WebWorks

Donaustr. 36 | 90451 Nürnberg (Germany) | +49 911 215 3470 |  kontakt@squidds.de Imprint | Privacy