Installation
WARNING
This is documentation for legacy versions. For the most current version click here.
In order to start using Markwon add this to your dependencies block
in your projects build.gradle:
implementation "ru.noties:markwon:${markwonVersion}"
This is core artifact that is sufficient to start displaying markdown in your Android applications.
Markwon comes with more artifacts that cover additional functionality, but they are
not required to be used, as most of them provide implementations for functionality
that is interfaced in the core artifact
implementation "ru.noties:markwon-image-loader:${markwonVersion}"
implementation "ru.noties:markwon-syntax-highlight:${markwonVersion}"
implementation "ru.noties:markwon-view:${markwonVersion}"
These artifacts share the same version as the core artifact
Image loader
implementation "ru.noties:markwon-image-loader:${markwonVersion}"
Provides implementation of AsyncDrawable.Loader and comes with support for:
- SVG
- GIF
- Other image formats
Please refer to documentation for image loader module
Syntax highlight
implementation "ru.noties:markwon-syntax-highlight:${markwonVersion}"
Provides implementation of SyntaxHighlight and allows various syntax highlighting
in your markdown based Android applications. Comes with 2 ready-to-be-used themes: light and dark.
Please refer to documentation for syntax highlight module
View
implementation "ru.noties:markwon-view:${markwonVersion}"
Provides 2 widgets to display markdown: MarkwonView and MarkwonViewCompat (subclasses
of TextView and AppCompatTextView respectively).
Please refer to documentation for view module
Proguard
When using markwon-image-loader artifact and Proguard is enabled, add these rules
to your proguard configuration:
-dontwarn okhttp3.**
-dontwarn okio.**
-keep class com.caverock.androidsvg.** { *; }
-dontwarn com.caverock.androidsvg.**
They come from dependencies that markwon-image-loader is using.
Other artifacts
Other artifacts do not require special Proguard rules
Snapshot
In order to use latest SNAPSHOT version add snapshot repository
to your root project's build.gradle file:
allprojects {
repositories {
jcenter()
google()
maven { url 'https://oss.sonatype.org/content/repositories/snapshots/' }
}
}
and then in your module build.gradle:
implementation "ru.noties:markwon:${markwonSnapshotVersion}"
Please note that markwon-image-loader, markwon-syntax-highlight
and markwon-view are also present in SNAPSHOT repository and
share the same version as main markwon artifact.