CKEditor 5

A set of ready-to-use rich text editors created with a powerful framework. Made with real-time collaborative editing in mind.

⚠ This package does not contain any source code

CKEditor 5 is distributed as four ready-to-use builds which you can install from npm.

You can also customize the existing builds or build your own editors and features by using the CKEditor 5 Framework.

Quick start
- CKEditor 5 Builds
- CKEditor 5 Framework
Documentation and FAQ
Contributing and project organization
Releases
Packages
- Core libraries
- Builds
- Features
- Editors
- Themes
License

Quick start

CKEditor 5 Builds

CKEditor 5 Builds are a set of ready-to-use rich text editors. Every "build" provides a single type of editor with a set of features and a default configuration.

The following CKEditor 5 Builds are currently available:

Example

Creating an editor using a CKEditor 5 build is very simple and can be described in two steps:

Load the desired editor via the <script> tag.
Call the static create() method to create the editor.

In your HTML page add an element that CKEditor should replace:

<textarea name="content" id="editor"></textarea>

Load the classic editor build (you can choose between CDN, npm and zip downloads):

<script src="https://cdn.ckeditor.com/ckeditor5/<version>/classic/ckeditor.js"></script>

Call the ClassicEditor.create() method:

<script>
    ClassicEditor
        .create( document.querySelector( '#editor' ) )
        .catch( error => {
            console.error( error );
        } );
</script>

You’re ready to go!

To find out how to start with other builds check the Quick start guide in the CKEditor 5 documentation.

CKEditor 5 Framework

CKEditor 5 Builds allow you to quickly and easily initialize one of the many types of editors in your application. At the same time, CKEditor 5 is also a framework for creating custom-made rich text editing solutions.

To find out how to start building your own editor from scratch go to CKEditor 5 Framework overview section of CKEditor 5 documentation.

Documentation and FAQ

To find out more see the following CKEditor 5 documentation sections:

The documentation is far from being complete and will be constantly evolving (as will the editor) until it is ready for v1.0.0.

For FAQ please go to the CKEditor Ecosystem help center. For a high-level overview of the project see the CKEditor Ecosystem website.

Contributing and project organization

Ideas and discussions

The main development repository of CKEditor 5 is located at https://github.com/ckeditor/ckeditor5. This is the best place for bringing opinions and contributions. Letting the core team know if they are going in the right or wrong direction is great feedback and will be much appreciated!

Development

CKEditor 5 is a modular, multi-package, multi-repository project. It consists of several packages that create the editing framework, based on which the feature packages are implemented.

The ckeditor5 repository is the place that centralizes the development of CKEditor 5. It bundles different packages into a single place, adding the necessary helper tools for the development workflow, like the builder and the test runner. Basic information on how to set up the development environment can be found in the documentation.

Reporting issues and feature requests

Each repository handles its issues independently. However, it is recommended to report issues in this repository unless you know to which specific repository the issue belongs.

Releases

The five latest releases:

First stable release – CKEditor 5 v10.0.0 (Apr 25, 2018)
Beta release of CKEditor 5 v1.0.0 (Apr 10, 2018)
Second alpha release of CKEditor 5 v1.0.0 (Nov 14, 2017)
First alpha release of CKEditor 5 v1.0.0 (Oct 3, 2017)
11th developer preview of CKEditor 5 (Sep 3, 2017)

For more CKEditor 5 release blog posts browse the CKEditor blog.

Packages

Core libraries

Name	Version	Description
`@ckeditor/ckeditor5-engine`		The editing engine.
`@ckeditor/ckeditor5-core`		The core editor architecture.
`@ckeditor/ckeditor5-ui`		The editor UI library.
`@ckeditor/ckeditor5-utils`		The editor utilities library.
`@ckeditor/ckeditor5-upload`		The file upload utilities.
`@ckeditor/ckeditor5-widget`		The widget API.
`@ckeditor/ckeditor5-cloud-services`		CKEditor 5's Cloud Services integration layer.

Builds

Name	Version	Description
`@ckeditor/ckeditor5-build-classic`		The classic editor build.
`@ckeditor/ckeditor5-build-inline`		The inline editor build.
`@ckeditor/ckeditor5-build-balloon`		The balloon editor (Medium-like) build.
`@ckeditor/ckeditor5-build-decoupled-document`		The document editor build, featuring the decoupled UI editor implementation.

Features

Name	Version	Description
`@ckeditor/ckeditor5-adapter-ckfinder`		The CKFinder adapter for features which require upload capabilities.
`@ckeditor/ckeditor5-alignment`		The text alignment feature.
`@ckeditor/ckeditor5-autoformat`		The autoformatting feature. Replaces predefined characters with a corresponding format (e.g. `foo` becomes bold `<strong>foo</strong>`).
`@ckeditor/ckeditor5-basic-styles`		The bold, italic, underline and code features.
`@ckeditor/ckeditor5-block-quote`		The block quote feature.
`@ckeditor/ckeditor5-clipboard`		The clipboard integration.
`@ckeditor/ckeditor5-enter`		The `Enter` key feature.
`@ckeditor/ckeditor5-easy-image`		Easy Image with CKEditor Cloud Services feature.
`@ckeditor/ckeditor5-font`		The font size and font family features.
`@ckeditor/ckeditor5-heading`		The heading feature.
`@ckeditor/ckeditor5-highlight`		The highlight feature (markers and pens).
`@ckeditor/ckeditor5-image`		The image feature. Supports image styles and captioning.
`@ckeditor/ckeditor5-link`		The link feature.
`@ckeditor/ckeditor5-list`		The numbered and bulleted lists feature.
`@ckeditor/ckeditor5-markdown-gfm`		The GitHub-flavored Markdown data processor.
`@ckeditor/ckeditor5-paragraph`		The paragraph feature.
`@ckeditor/ckeditor5-typing`		The typing and deleting features.
`@ckeditor/ckeditor5-undo`		The undo feature.

Editors

Name	Version	Description
`@ckeditor/ckeditor5-editor-classic`		The classic editor implementation.
`@ckeditor/ckeditor5-editor-inline`		The inline editor implementation.
`@ckeditor/ckeditor5-editor-balloon`		The balloon editor (Medium-like) implementation.
`@ckeditor/ckeditor5-editor-decoupled`		The editor implementation with a decoupled UI.