pkgs/markdown/README.md

dartdoc markdown library
========================

This is a standalone version of the [dartdoc][dartdoc] markdown library. It 
parses markdown and converts it to HTML.

You can see a demo running in the browser [here][demo] (tested in Chrome 
and Dartium). The client library currently only supports HTML syntax 
highlighting do to some dart:io dependencies in libcss and analyzer_experimental.

Installation
------------

Add this to your `pubspec.yaml` (or create it):
```yaml
dependencies:
  markdown: any
```
Then run the [Pub Package Manager][pub] (comes with the Dart SDK):

    pub install

Usage
-----

```dart
import 'package:markdown/markdown.dart' show markdownToHtml;

main() {
  print(markdownToHtml('Hello *Markdown*'));
}
```

Version 0.4 adds support for GitHub style triple backtick code blocks, with 
built in Dart syntax coloring. Custom classifiers can be added using a callback:

```dart
import 'package:markdown/markdown.dart' show markdownToHtml;

main() {
  print(markdownToHtml("Hello *Markdown*"), (syntax, source) {
    if (syntax == 'mysyntax') return classifySyntax(source);
    return source;
  });
}

String classifySyntax(String source) {
	return '<span class="mysyntax">$source</span>';
}
```

[dartdoc]: http://code.google.com/p/dart/source/browse/trunk/dart/sdk/lib/_internal/dartdoc
[pub]: http://www.dartlang.org/docs/pub-package-manager
[demo]: http://dpeek.github.com/dart-markdown