FAQ / Technology and features

Technology and features

Which tools and SDKs exist for integrating Contentful?

There's plenty of them. Naturally, we want to help you get started quickly, so there are tools and SDKs available for all the major platforms.

See also: Developer center

What platforms does Contentful support?

Contentful provides a powerful JSON API through which all your content is served.

You can load the content on any platform which supports the creation of HTTP requests and which can parse JSON. JSON is a lighter and faster alternative to XML and used in almost all modern web services. Any modern programming language has tools to parse JSON, which allows you to distribute your content to virtually any platform.

Examples of platforms and languages into which content can be loaded:


  • HTML4 websites
  • Interactive HTML5 sites or applications with JavaScript (Backbone.js, Ember.js, Angular.js, …)

Native mobile apps

  • Apple iOS
  • Android
  • Google Glass
  • Windows Phone
  • Blackberry
  • Java ME
  • Sencha Touch
  • Phonegap
  • Titanium Appcelerator

Desktop applications

  • Windows (all versions)
  • Apple Mac OS X
  • Linux

Any client or server-side programming environment

  • C
  • Java
  • .NET
  • Python
  • Ruby
  • PHP
  • Go

The platform does not need to support JavaScript, it only needs to be able to parse JSON. We are working on SDKs for many of the above platforms, which will make using your content even easier. You can also load the content out of Contentful and generate static documents out of it, such as printed documents or eBooks.

Does Contentful work with HTML and JavaScript?

Yes, and there are three ways to serve content in HTML.

1. Generating pages dynamically on the server

This is the classic approach taken by most CMSs to generate HTML4 websites. A browser requests a website and then a server-based system loads content from a database, creates an HTML page based on templates on the fly, and sends that HTML page back to the browser.

Exactly the same approach works with content from Contentful. You can use the server-side programming language and frameworks of your choice (PHP, Ruby, Python, Java, .NET, or even JavaScript with Node.js), together with your preferred templating system, to generate pages dynamically on each request.

Due to the high performance of our API and our world-wide CDN the page load times will still be very quick, no matter where your servers are.

2. Pre-generating static pages with a site generator

If you mostly serve static content then pre-generating all the HTML pages is the best approach to take. An example for this might be a landing page or a blog.

Again, you can use the programming and templating frameworks of your choice. An example in Ruby might be Middleman, which can easily be integrated with Contentful with the Contentful middleman extension. Every time content is updated every single page is pre-generated and then uploaded to a web server or a Content Delivery Network. This approach guarantees you the highest availability, the lowest page load times and the highest security.

3. Dynamically loading content into the browser with JavaScript

With Contentful you can build highly dynamic JavaScript-based applications in the framework of your choice (Backbone.js, Ember.js, Angular.js, jQuery) or even with pure JS and AJAX requests.

A very simple HTML page is sent to the browser initially, and only in a second step the content is loaded dynamically through AJAX. This approach gives you the most flexibility in working with content, as you could potentially display it on a Google Map or even render it in 3D through WebGL.

Which way you go depends highly on the requirements of your project. The approaches described above can also be combined.

Markdown Parser Recommendations By Language

If you're looking for a markdown parser for your app or website, here's a list of the ones we recommend you to use:

Java: https://github.com/sirthias/pegdown

Pegdown is a pure-Java Markdown processor based on a parboiled PEG parser supporting a number of extensions.

js: https://github.com/chjj/marked

Marked is markdown parser and compiler. Built for speed.

php: https://github.com/kzykhys/Ciconia

Ciconia is a New Markdown parser for PHP5.4.

ruby: https://github.com/jjyr/minidown

Minidown is a lightweight & fast markdown parser, with complete GFM support.

python lib: https://github.com/FSX/misaka

Misaka is a Python binding for Hoedown.

.NET C#: https://code.google.com/p/markdownsharp/

Markdownsharp is a open source C# implementation of Markdown processor, as featured on Stack Overflow.


GHMarkdown: https://github.com/OliverLetterer/GHMarkdownParser

•    No code blocks
•    Only produces HTML
•    Minimal support for tables

CocoaMarkdown: https://github.com/indragiek/CocoaMarkdown

•    No support for tables
•    Images are not displayed, alt text inline
•    No strikethrough
•    No inline HTML
•    No horizontal rule