Nothing Special   »   [go: up one dir, main page]

Skip to content

Minimal C bindings for parsing and rendering with cmark-gfm

License

Notifications You must be signed in to change notification settings

mamantoha/crystal-cmark-gfm

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

46 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CommonMarker

Crystal CI GitHub release License

Crystal wrapper for cmark-gfm, GitHub's fork of the reference parser for CommonMark.

This binding is statically linked with a specific version of cmark-gfm.

cmark-gfm supports simple parsing and rendering of markdown content.

If you want more features please check cr-cmark-gfm.

Installation

  1. Add the dependency to your shard.yml:

    dependencies:
      common_marker:
        github: mamantoha/crystal-cmark-gfm
  2. Run shards install

Usage

require "common_marker"

text = File.read("README.md")
extensions = ["table", "strikethrough", "autolink", "tagfilter", "tasklist"]
options = ["unsafe"]
md = CommonMarker.new(text, options: options, extensions: extensions)
html = md.to_html

Extensions

CommonMarker initializer takes an optional third argument defining the extensions you want enabled as your CommonMark document is being processed. The documentation for these extensions are defined in this spec.

The available extensions are:

  • table - This provides support for tables.
  • strikethrough - This provides support for strikethroughs.
  • autolink - This provides support for automatically converting URLs to anchor tags.
  • tagfilter - This escapes several "unsafe" HTML tags, causing them to not have any effect.
  • tasklist - This provides support for task list items.

Development

cd ext && make && cd ..
crystal ./lib/crystal_lib/src/main.cr src/lib_cmark.cr.in > ./src/lib_cmark.cr

Contributing

  1. Fork it (https://github.com/mamantoha/crystal-cmark-gfm/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