Skip to content

Commit 128b6c5

Browse files
committed
0.3.0
1 parent 695eecf commit 128b6c5

File tree

3 files changed

+18
-4
lines changed

3 files changed

+18
-4
lines changed

Cargo.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
[package]
22
name = "comrak"
3-
version = "0.2.14"
3+
version = "0.3.0"
44
authors = ["Ashe Connor <[email protected]>"]
55
description = "A 100% CommonMark-compatible GitHub Flavored Markdown parser and formatter"
66
documentation = "https://docs.rs/comrak"

README.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,30 +13,31 @@ Rust port of [github's `cmark-gfm`](https://github.com/github/cmark).
1313
* [Contributors](#contributors)
1414
* [Legal](#legal)
1515

16+
1617
## Installation
1718

1819
Specify it as a requirement in `Cargo.toml`:
1920

2021
```toml
2122
[dependencies]
22-
comrak = "0.2"
23+
comrak = "0.3"
2324
```
2425

26+
2527
## Usage
2628

2729
A binary is included which does everything you typically want:
2830

2931
```
3032
$ comrak --help
31-
comrak 0.2.14
33+
comrak 0.3.0
3234
Ashe Connor <[email protected]>
3335
A 100% CommonMark-compatible GitHub Flavored Markdown parser and formatter
3436
3537
USAGE:
3638
comrak [FLAGS] [OPTIONS] [--] [FILE]...
3739
3840
FLAGS:
39-
--footnotes Parse footnotes
4041
--github-pre-lang Use GitHub-style <pre lang> for code blocks
4142
--hardbreaks Treat newlines as hard line breaks
4243
-h, --help Prints help information
@@ -110,12 +111,14 @@ assert_eq!(
110111
</ol>\n");
111112
```
112113

114+
113115
## Security
114116

115117
As with [`cmark-gfm`](https://github.com/github/cmark#security), Comrak will pass through inline HTML, dangerous links, anything you can imagine — it only performs Markdown to HTML conversion per the CommonMark/GFM spec. We recommend the use of a sanitisation library like [`ammonia`](https://github.com/notriddle/ammonia) configured specific to your needs.
116118

117119
You can also disable this potentially unsafe feature by using the `safe` option (or `--safe` at the command-line).
118120

121+
119122
## Extensions
120123

121124
Comrak supports the five extensions to CommonMark defined in the
@@ -133,6 +136,7 @@ By default none are enabled; they are individually enabled with each parse by
133136
setting the appropriate values in the
134137
[`ComrakOptions` struct](https://docs.rs/comrak/newest/comrak/struct.ComrakOptions.html).
135138

139+
136140
## Related projects
137141

138142
Comrak's design goal is to model the upstream [`cmark-gfm`](https://github.com/github/cmark) as closely as possible in terms of code structure. The upside of this is that a change in `cmark-gfm` has a very predictable change in Comrak. It helps that I maintain both, and tend to update Comrak in lock-step with `cmark-gfm`. Likewise, any bug in `cmark-gfm` is likely to be reproduced in Comrak. This could be considered a pro or a con, depending on your use case.
@@ -145,6 +149,7 @@ The downside, of course, is that the code is not what I'd call idiomatic Rust (_
145149

146150
As far as I know, Comrak is the only library to implement all of the [GitHub Flavored Markdown extensions](https://github.github.com/gfm) to the spec, but this tends to only be important if you want to reproduce GitHub's Markdown rendering exactly, e.g. in a GitHub client app.
147151

152+
148153
## Contributors
149154

150155
Thank you for PRs and issues opened!
@@ -164,6 +169,7 @@ Thank you for PRs and issues opened!
164169
* [steveklabnik](https://github.com/steveklabnik)
165170
* [brson](https://github.com/brson)
166171
* [Keats](https://github.com/Keats)
172+
* [ayosec](https://github.com/ayosec)
167173

168174
## Legal
169175

changelog.txt

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,11 @@
1+
### 0.3.0
2+
3+
* Significant test coverage and code clean up. (#82, #83, Brian Anderson)
4+
* Description list support. (#86, Ayose Cazorla)
5+
* Example use of comrak to convert CommonMark documents into S-expressions. (#86, Ayose Cazorla)
6+
* Footnotes are now enabled via an extension option, not a flag of its own. (#87)
7+
* Extend `cmark-gfm` compatibility to include all extension and regression tests. (#87)
8+
19
### 0.2.14
210

311
* Speed enhancements. (#76, Brian Anderson)

0 commit comments

Comments
 (0)