mirror of
https://github.com/quitesimpleorg/qsmaddy.git
synced 2024-12-03 11:52:36 +01:00
Fork of maddy, a C++ Markdown to HTML header-only parser library.
docs | ||
include/maddy | ||
libs | ||
tests | ||
.editorconfig | ||
.gitignore | ||
.gitmodules | ||
.travis.yml | ||
appveyor.yml | ||
AUTHORS | ||
CHANGELOG.md | ||
CMakeLists.txt | ||
CONTRIBUTING.md | ||
ISSUE_TEMPLATE.md | ||
LICENSE | ||
README.md |
maddy
maddy is a C++ Markdown to HTML header-only parser library.
Supported OS
It actually should work on any OS, that supports the C++14 standard library.
It is tested to work on:
- Linux (gcc)
- OSX (clang)
- Windows (Visual Studio 2017)
Dependencies
- C++14
Why maddy?
When I was needing a Markdown parser in C++ I couldn't find any, that was fitting my needs. So I simply wrote my own one.
Markdown syntax
The supported syntax can be found in the definitions docs.
How to use
To use maddy in your project, simply add the include path of maddy to yours and in the code, you can then do the following:
#include <memory>
#include <string>
#include "maddy/parser.h"
std::stringstream markdownInput("");
// config is optional
std::shared_ptr<maddy::ParserConfig> config = std::make_shared<maddy::ParserConfig>();
config->isEmphasizedParserEnabled = true; // default
config->isHTMLWrappedInParagraph = true; // default
std::shared_ptr<maddy::Parser> parser = std::make_shared<maddy::Parser>(config);
std::string htmlOutput = parser->Parse(markdownInput);
How to run the tests
(tested on Linux with git and cmake installed)
Open your preferred terminal and type:
git clone https://github.com/progsource/maddy.git
cd maddy
git submodule update --init --recursive
mkdir tmp
cd tmp
cmake ..
make
make test # or run the executable in ../build/MaddyTests
How to contribute
There are different possibilities:
- Create a GitHub issue
- Create a pull request with an own branch (don't forget to put yourself in the AUTHORS file)
Please also read CONTRIBUTING.md.