MarkdownView

WebView implementation supporting Markdown rendering.

MarkdownView

Prerequisites

Add this in your root build.gradle file (not your module build.gradle file):

allprojects {
	repositories {
		...
		maven { url "https://jitpack.io" }
	}
}
Gradle

Dependency

Add this to your module's build.gradle file (make sure the version matches the JitPack badge above):

dependencies {
	...
	implementation 'com.github.GrenderG:MarkdownView:0.1.2'
}
Gradle

Basic usage

NOTE: You will need to specify INTERNET permission in your project if you want to load Internet resources.

First of all, all the View where you want:

<es.dmoral.markdownview.MarkdownView
        android:id="@+id/markdown_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />
XML

Loading Markdown text:

markdownView.loadFromText("### Loading some Markdown!\nHey there.");
Java

Loading Markdown from a File:

markdownView.loadFromFile(new File("path/to/md/file"));
Java

Loading Markdown from Android assets:

markdownView.loadFromAssets("path/to/file/in/assets");
Java

Loading Markdown from URL:

markdownView.loadFromURL("https://raw.githubusercontent.com/GrenderG/MarkdownView/master/README.md");
Java

Advanced usage

MarkdownView uses css files to stylize everything, you can customize them too:

markdownView.setCurrentConfig(new Config(
	"file:///android_asset/custom_css_file.css",
	Config.CssCodeHighlight.MONOKAI_SUBLIME // This can be a custom one too, but there are already added some options.
));
Java

Internally, MarkdownView uses an OkHttpClient to load files from URLs, you can set a custom one if you want:

Config defaultConfig = Config.getDefaultConfig();
        
defaultConfig.setDefaultOkHttpClient(new OkHttpClient().newBuilder().addInterceptor(
        new Interceptor() {
            @Override
            public Response intercept(Chain chain) throws IOException {
                Request request = chain.request();
                Request authenticatedRequest = request.newBuilder()
                        .header("Authorization", "Basic OIxhJGHpbjpvcGVuc2VzYW1l").build();
                return chain.proceed(authenticatedRequest);
            }
        }
).build());

markdownView.setCurrentConfig(defaultConfig);
Java

You can also set the margins of the content (in px):

Config defaultConfig = Config.getDefaultConfig();
        
defaultConfig.setDefaultMargin(16);

markdownView.setCurrentConfig(defaultConfig);
Java

There's also a rendering listener which will provide you info if there's an error rendering the Markdown and when it has finished rendering (near perfect timing).

markdownView.setOnMarkdownRenderingListener(new MarkdownView.OnMarkdownRenderingListener() {
        @Override
        public void onMarkdownFinishedRendering() {
            // Rendered!
        }

        @Override
        public void onMarkdownRenderError() {
	    // Error rendering
        }
    });
Java

GitHub