#etch

bin+lib etch

Not just a text formatter, don’t mark it down, etch it

3 releases (breaking)

✓ Uses Rust 2018 edition

0.3.0 Jul 11, 2019
0.2.0 Jun 4, 2019
0.1.0 May 26, 2019

31 downloads per month

MIT license

93KB
2.5K SLoC

Etch v0.3.0

Not just a text formatter, don't mark it down, etch it.

  • Not too dissimilar from Markdown, simpler yet also more powerful:

    # My Document
    
    This is what etch text looks like!
    
    [a]
    You can tag entire blocks of text with a tag prefix, individual words[b]
    with a tag suffix, or [entire spans of text][b] using square brackets.
    
    #[a: .myClass]
    #[b: @alt surprise alt text!]
    #[c: @https://example.com]
    
    And lastly, tags can be declared when you first reference them[d: .nice]
    and the tag name is optional[.cool].
    
  • Documents can import other documents:

    #import[my-document.etch]
    

    Or other files as preformatted text:

    [css]
    #import[my-css-example.css]
    
  • Documents can contain custom metadata such as a title or description:

    #meta[title: My Document]
    
  • Plugin API allows for transforming documents or injecting custom parsers.

  • Code syntax highlighting provided by the Syntect plugin.

A more complete example of Etch syntax can be found in the samples directory.

Dependencies

~2MB
~32K SLoC