@ckeditor/ckeditor5-markdown-gfm

What is @ckeditor/ckeditor5-markdown-gfm?

@ckeditor/ckeditor5-markdown-gfm is a plugin for CKEditor 5 that allows you to convert the editor's content to GitHub Flavored Markdown (GFM) and vice versa. This package is particularly useful for applications that need to support markdown editing and rendering, providing a seamless way to handle markdown content within a rich text editor.

What are @ckeditor/ckeditor5-markdown-gfm's main functionalities?

Markdown to HTML Conversion

This feature allows you to initialize CKEditor with the Markdown plugin, enabling the conversion of markdown content to HTML within the editor.

const ClassicEditor = require('@ckeditor/ckeditor5-build-classic');
const Markdown = require('@ckeditor/ckeditor5-markdown-gfm/src/markdown');

ClassicEditor
    .create(document.querySelector('#editor'), {
        plugins: [Markdown],
        toolbar: ['bold', 'italic', 'link']
    })
    .then(editor => {
        console.log('Editor was initialized', editor);
    })
    .catch(error => {
        console.error(error.stack);
    });

HTML to Markdown Conversion

This feature allows you to convert the HTML content within the CKEditor back to markdown format, making it easy to store or manipulate markdown data.

const ClassicEditor = require('@ckeditor/ckeditor5-build-classic');
const Markdown = require('@ckeditor/ckeditor5-markdown-gfm/src/markdown');

ClassicEditor
    .create(document.querySelector('#editor'), {
        plugins: [Markdown],
        toolbar: ['bold', 'italic', 'link']
    })
    .then(editor => {
        const markdownData = editor.plugins.get('Markdown').getMarkdown();
        console.log('Markdown data:', markdownData);
    })
    .catch(error => {
        console.error(error.stack);
    });

Other packages similar to @ckeditor/ckeditor5-markdown-gfm

markdown-it

markdown-it is a markdown parser that supports GitHub Flavored Markdown and can be extended with plugins. Unlike @ckeditor/ckeditor5-markdown-gfm, markdown-it is not tied to a specific editor and can be used in various contexts where markdown parsing is needed.

showdown

Showdown is a JavaScript markdown to HTML converter, compatible with GitHub Flavored Markdown. It is a standalone library that can be integrated with different editors or used independently, offering more flexibility compared to the CKEditor-specific @ckeditor/ckeditor5-markdown-gfm.

marked

Marked is a fast markdown parser and compiler that supports GitHub Flavored Markdown. It is highly configurable and can be used in various environments, providing a more general-purpose solution compared to the CKEditor-specific @ckeditor/ckeditor5-markdown-gfm.

README

GitHub Flavored Markdown support for CKEditor 5

This package implements the GitHub Flavored Markdown data processor for CKEditor 5.

Installation

This plugin is part of the ckeditor5 package. Install the whole package to use it.

npm install ckeditor5

Create free account

If you want to check full CKEditor 5 capabilities, sign up for a free non-commitment 14-day trial.

Demo

Check out the demo in the Markdown output feature guide to see the editor configured to input and output Markdown code. Use the demo in the Paste Markdown feature guide to try out experimental pasting Markdown-formatted content straight into the editor.

Documentation

See the @ckeditor/ckeditor5-markdown-gfm package page as well as the Markdown output and Paste Markdown in CKEditor 5 documentation.

License

Licensed under a dual-license model, this software is available under:

• the GNU General Public License Version 2 or later,
• or commercial license terms from CKSource Holding sp. z o.o.

For more information, see: https://ckeditor.com/legal/ckeditor-licensing-options.

Changelog

44.3.0 (March 5, 2025)

We are happy to announce the release of CKEditor 5 v44.3.0.

Release Highlights

This release brings a couple of minor improvements and bug fixes:

• Link Decorators: We fixed the behavior of the multiple manual link decorators that set the rel attribute. The fix happened so deep in the engine that we improved the overall performance of the editor slightly as well.
• Added a new EmptyBlock plugin: From now on, new plugin prevents adding   to the output data of blocks, works similarly to the fillEmptyBlocks configuration in CKEditor 4.
• Support for the <hr> element in the General HTML Support plugin enhanced: attributes of the <hr> element are now properly preserved if configuration allows it.
• Emoji: We enhanced emoji support for better compatibility with users' older devices.

For more details, see the changelog below.