react-native-enriched-markdown is a powerful React Native library that renders Markdown content as native text and provides a rich text input with Markdown output. It supports iOS, Android, and macOS, and requires the New Architecture (Fabric).
- ⚡ Fully native text rendering (no WebView)
- 🎯 High-performance Markdown parsing with md4c
- 📐 CommonMark standard compliant
- 📊 GitHub Flavored Markdown (GFM)
- 🧮 LaTeX math rendering (block
$$...$$withflavor="github", inline$...$in all flavors) - 🔀 Markdown Streaming support (via react-native-streamdown)
- 🎨 Fully customizable styles for all elements
- ✨ Text selection and copy support
- 📌 Custom text selection context menu items
- 🔗 Interactive link handling
- 🖼️ Native image interactions (iOS: Copy, Save to Camera Roll)
- 🌐 Native platform features (Translate, Look Up, Search Web, Share)
- 🗣️ Accessibility support (VoiceOver on iOS, TalkBack on Android)
- 🔄 Full RTL (right-to-left) support including text, lists, blockquotes, tables, and task lists
- ✏️ Rich text input with Markdown output
- 🕹️ Imperative API for toggling styles and managing links
- 📋 Native format bar and context menu with formatting options
- 🔍 Real-time style state detection
- 🔗 Auto-link detection with customizable regex
- 🔄 Smart copy/paste with Markdown preservation
- 🎨 Customizable bold, italic, and link colors
Since 2012 Software Mansion is a software agency with experience in building web and mobile apps. We are Core React Native Contributors and experts in dealing with all kinds of React Native issues. We can help you build your next dream product – Hire us.
- Prerequisites
- Installation
- EnrichedMarkdownText
- EnrichedMarkdownInput
- API Reference
- macOS Support
- Contributing
- Future Plans
- License
- Supports iOS, Android, and macOS platforms
- Requires the React Native New Architecture (Fabric)
- Supported React Native releases:
0.81,0.82,0.83, and0.84 - macOS support via react-native-macos
0.81+
yarn add react-native-enriched-markdownTip
To try the latest features before they land in a stable release, install the nightly build:
yarn add react-native-enriched-markdown@nightlyNightly versions are published to npm automatically and may contain breaking changes.
The library includes native code so you will need to re-build the native app.
# iOS
cd ios && bundle install && bundle exec pod install
# macOS (react-native-macos)
cd macos && bundle install && bundle exec pod installnpx expo install react-native-enriched-markdownThe library includes native code so you will need to re-build the native app.
npx expo prebuildNote
The library won't work in Expo Go as it needs native changes.
Important
iOS: Save to Camera Roll
If your Markdown content includes images and you want users to save them to their photo library, add the following to your Info.plist:
<key>NSPhotoLibraryAddUsageDescription</key>
<string>This app needs access to your photo library to save images.</string>See EnrichedMarkdownText for detailed documentation on usage examples, GFM tables, task lists, link handling, supported elements, copy options, accessibility, RTL support, and customizing styles.
See EnrichedMarkdownInput for detailed documentation on usage examples, inline styles, links, style detection, events, and customizing styles.
See the API Reference for a detailed overview of all the props, methods, and events available.
react-native-enriched-markdown supports macOS via react-native-macos. See macOS Support for details on macOS-specific features, known limitations, and the example app.
We're actively working on expanding the capabilities of react-native-enriched-markdown. Here's what's on the roadmap:
EnrichedMarkdownInput: headings, lists, blockquotes, code blocks, mentions, inline images- Web implementation via
react-native-web - macOS: block math rendering, VoiceOver accessibility, tail fade-in animation
See the contributing guide to learn how to contribute to the repository and the development workflow.
react-native-enriched-markdown library is licensed under The MIT License.
Built by Software Mansion.
