Skip to content

Latest commit

 

History

History
167 lines (118 loc) · 6.69 KB

README.md

File metadata and controls

167 lines (118 loc) · 6.69 KB
Raw

Markdown Editor

Netlify Status downloads GitHub license npm version join slack

This repo contains two React-based editors:

  1. A WYSIWYG Slate-based editor that edits rich text and calls an onChange callback with the modified Slate DOM.
  2. A TextArea-based markdown editor that edits markdown text and calls an onChange callback with the modified markdown text.

The demo editor uses the markdown-transform package to transform Slate DOM to/from markdown text.

Using these editors you could allow people to either edit rich formatted text using markdown (and provide a WYSIWYG preview), or allow them to edit using a WYSIWYG editor and use markdown for persistence.

The editor includes a formatting toolbar.

This component is Apache-2 licensed Open Source. Contributors welcome!

Demo

Usage

npm install @accordproject/markdown-editor

import { SlateAsInputEditor } from '@accordproject/markdown-editor';
import List from '@accordproject/markdown-editor/dist/plugins/list';
import Video from '@accordproject/markdown-editor/dist/plugins/video';
import { SlateTransformer } from '@accordproject/markdown-slate';

const plugins = [List()];
const slateTransformer = new SlateTransformer();

function storeLocal(slateValue) {
  const markdown = slateTransformer.toMarkdown(slateValue);
  localStorage.setItem('markdown-editor', markdown);
}

ReactDOM.render(<SlateAsInputEditor plugins={plugins} lockText={false} onChange={storeLocal}/>
, document.getElementById('root'));

Example

For an example React App see the ./examples/ folder.

A TextArea containing CommonMark synchronized with a MarkdownEditor component, rendered using Slate.

overview image

In order to run an isolated local development example, run npm run dev and then navigate to: http://localhost:3001/examples

Available Scripts

In the project directory, you can run:

npm run dev

Runs the app in the development mode.
Open http://localhost:3001/examples to view it in the browser.

The page will reload if you make edits.

npm run build

Builds the app for production to the build folder.
It correctly bundles React in production mode and optimizes the build for the best performance.

The build is minified and the filenames include the hashes.
Your app is ready to be deployed!

Styling

You can style the toolbar of this component, as well as the width of the editor:

editorProps

This is an object with the following possible css inputs as strings:

  • BUTTON_BACKGROUND_INACTIVE
  • BUTTON_BACKGROUND_ACTIVE
  • BUTTON_SYMBOL_INACTIVE
  • BUTTON_SYMBOL_ACTIVE
  • DROPDOWN_COLOR
  • TOOLBAR_BACKGROUND
  • TOOLTIP_BACKGROUND
  • TOOLTIP
  • TOOLBAR_SHADOW
  • WIDTH

Accord Project Logo

Accord Project is an open source, non-profit, initiative working to transform contract management and contract automation by digitizing contracts. Accord Project operates under the umbrella of the Linux Foundation. The technical charter for the Accord Project can be found here.

Learn More About Accord Project

Overview

Documentation

Contributing

The Accord Project technology is being developed as open source. All the software packages are being actively maintained on GitHub and we encourage organizations and individuals to contribute requirements, documentation, issues, new templates, and code.

Find out what’s coming on our blog.

Join the Accord Project Technology Working Group Slack channel to get involved!

For code contributions, read our CONTRIBUTING guide and information for DEVELOPERS.

License

Accord Project source code files are made available under the Apache License, Version 2.0. Accord Project documentation files are made available under the Creative Commons Attribution 4.0 International License (CC-BY-4.0).