cr-discount

Version, currently 0.1.03 versions

github.com/ralsina/cr-discount

A thin Crystal wrapper for discount, a markdown implementation

2 stars
1 dependent
License: MIT

Nothing has been indexed for 0.1.0 yet. The tag is recorded, its shard.yml has not been read, so the manifest and dependency list below are empty because they are unknown rather than because they are absent.

Installation

# Add this to your shard.yml
dependencies:
  cr-discount:
    github: ralsina/cr-discount
    version: ~> 0.1.0

Then run:

shards install

shard.yml

No shard.yml has been indexed for 0.1.0. You can read it on the repository.

Dependencies

Unknown: the shard.yml for this version has not been read yet.

README

This README is the one indexed from the repository at its latest ref, not from the tag for this version.

cr-discount

A crystal wrapper for Discount, a Markdown implementation

Installation

  1. Add the dependency to your shard.yml:

    dependencies:
      cr-discount:
        github: ralsina/cr-discount
  2. Run shards install

Usage

require "cr-discount"

You can use Discount to compile markdown to HTML like this:

      markdown = "This *is* **markdown**"
      html = Discount.compile(markdown)

This is the whole API:

  # Compile `text` from Markdown to HTML
  def self.compile(
    text : String,
    with_toc : Bool = false,
    flags = LibDiscount::MKD_FENCEDCODE | LibDiscount::MKD_TOC
  )
  • with_toc adds a simple table of contents at the beginning of the returned HTML
  • flags can be any combination of the flags in the discount docs

Development

I am not planning on developing this much further since it already does what I want :-)

Contributing

  1. Fork it (https://github.com/ralsina/cr-discount/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Contributors