An extended markdown parser written in pure rust

You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

Go to file

trivernis dd65c65c9d Refactor project folder and file structure - add folders for references and utils as well as elements - extract the line and inline parsing of the parser into separate traits		5 years ago
src	Refactor project folder and file structure	5 years ago
tests	Refactor project folder and file structure	5 years ago
.gitignore	Add automated parsing tests	5 years ago
Cargo.lock	Refactor project folder and file structure	5 years ago
Cargo.toml	Refactor project folder and file structure	5 years ago
LICENSE	Create LICENSE	5 years ago
README.md	Add optional comma to metadata	5 years ago

README.md

🐍 Snekdown - More than just Markdown

This projects goal is to implement a fast markdown parser with an extended syntax fitted for my needs.

Usage

USAGE:
    snekdown [OPTIONS] <input> <output> [SUBCOMMAND]

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information

OPTIONS:
    -f, --format <format>    the output format [default: html]

ARGS:
    <input>     Path to the input file
    <output>    Path for the output file

SUBCOMMANDS:
    help      Prints this message or the help of the given subcommand(s)
    render    Default. Parse and render the document
    watch     Watch the document and its imports and render on change

Syntax

Images

Simple Syntax
!(url)

Extended syntax with a description
![description](url)

Extended syntax with metadata to specify the size
![description](url)[metadata]

Extended syntax with metadata and no description
!(url)[metadata]

Quotes

Simple (default) Syntax
> This is a quote

Multiline
> This is a 
> Multiline Quote

Quote with metadata (e.g. Author)
[author=Trivernis year=2020 display='{{author}} - {{year}}']> This is a quote with metadata

Imports

Imports can be used to import a different document to be attached to the main document. Imports are parsed via multithreading.

<[path]

Tables

Tables MUST start with a pipe character |

Standalone header:
| header | header | header

Header with rows
| header | header | header
|--------|--------|-------
| row    | row    | row

Placeholders

Placeholders can be used to insert special elements in a specific place. Placeholders are always case insensitive.

Insert the table of contents
[[TOC]]

Insert the current date
[[date]]

Insert the current time
[[time]]

Metadata

Additional metadata can be provided for some elements.

String value
[key = value]

String value
[key = "String value"]

Integer value
[key = 123]

Float value
[key = 1.23]

Boolean
[key] 

Boolean
[key = false]

Placeholder
[key = [[placeholder]]]

Formatting
[author = "The Great snek" date = [[date]] time = [[time]] display = "author - date at time"]

Usage

Hide a section (including subsections) in the TOC
#[toc-hidden] Section

Set the size of an image
!(url)[width = 42% height=auto]

Set the source of a quote
[author=Me date=[[date]] display="{{author}} - {{date}}"]> It's me

Set options for placeholders
[[toc]][ordered]

Centered Text

|| These two lines
|| are centered

Inline

*Italic*
**Bold**
~Striked~
_Underlined_
^Superscript^
`Monospace`
:Emoji:
§[#0C0]Colored text§[] §[red] red §[]

Bibliography

Bibliography entries can be defined and referenced anywhere in the document.

Definition:

[book]:[author=Snek, title = "Snekdown Book"]
[github]: https://github.com/trivernis/snekdown

Usage:

There is a book about snekdown[^book] and a github repo[^github].

Bibliography entries are only shown when used in the document.

Roadmap

The end goal is to have a markup language with features similar to LaTeX.

Checkboxes
Emojis (:emoji:)
Colors
Watching and rendering on change
Metadata files
Bibliography
Math
Text sizes
Title pages
Glossary
Cross References
Figures
EPUB Rendering (PDF is too hard)
Custom Elements via templates (50%)
Custom Stylesheets