Tiptap’s Conversion tools support handling Markdown (.md) files in three ways:
Editor Import – Convert .md files directly into Tiptap JSON for in-editor editing.
Editor Export – Convert Tiptap content into .md (either standard Markdown or GitHub Flavored Markdown).
REST API – Integrate markdown conversion on the server with the MD conversion REST API, without using the Tiptap editor directly.
Subscription required
These extensions require a valid Tiptap subscription. To install the extension, you need access to our
private registry.
Editor Markdown Import
Install the Import extension:
npm i @tiptap-pro/extension-import
Configure the extension in your editor
import { Import } from'@tiptap-pro/extension-import'const editor = newEditor({
// ...extensions: [
// ...Import.configure({
// Your Convert App ID from https://cloud.tiptap.dev/convert-settingsappId: 'your-app-id',
// JWT token you generatedtoken: 'your-jwt',
// If your markdown includes images, you can provide a URL for image uploadimageUploadCallbackUrl: 'https://your-image-upload-url.com',
}),
],
})
Import your first document
editor.chain().focus().import({ file }).run()
This uploads the chosen .md file to the Conversion API, converts it into Tiptap JSON, and replaces the current editor content.