Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
lib
 
 
man
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

caoutchouc

Markdown for formatting + AsciiMath for math + Latex for the weird stuff

What is caoutchouc?

A replacement for LaTeX based on Markdown and AsciiMath.

Why use caoutchouc?

Here's the same document written in both LaTeX and Caoutchouc:

LaTeX Caoutchouc
\documentclass{article}
\usepackage[utf8]{inputenc}
\begin{document}

\section{Introduction}

$$\dfrac{1\cdot \alpha}{2}$$

\begin{figure}
\centering
\includegraphics[width=9cm]{image}
\caption{A caption}
\end{figure}

\end{document}




# Introduction

€€(1*alpha)/2€€



![A caption](image.png)




It's easy to see that the Caoutchouc version is much more readable, easy, simple and less verbose.

For a detailed explanation of the improvements that Caouchouc brings over LaTeX, read Why was caoutchouc created?.

Try it!

Go to ShareCaou.com and login using:

email: test@test.com
password: caoutchouc

The site could be slow and may collapse under heavy load, as it's running on a basic VPS.

Install

Pre-requisites: A local installation of texlive.

npm install -g caou

Usage

caou file.md # Generates file.pdf

For more information about the caou compiler, run man caou.

If you'd like to find out more about caoutchouc, go to caoutchouc.io.

Caoutchouc example

Caoutchouc Result
# Caoutchouc

- **Markdown**[^1]
- **Math** made easy: €1+2*sqrt(2)-pi+alpha/(3.2-1)€
- **LaTeX** can be directly embedded:
\usepackage{xcolor}
\colorbox{red}{Colored text!}

$$x\overset{\Bbb{R}}{+} y=x\overset{\Bbb{Q}}{+} y$$

[^1]: extended with footnotes and many other goodies from pandoc-flavoured markdown
Pdf representation
                                                                               

Go to caoutchouc.io for proper documentation.

Contributing

All contributions are welcome but help is specially appreciated in the following tasks:

  • Set up scalable hosting for ShareCaou (currently it's in a simple vps). I can pay for all the hosting costs.
  • Create a logo for Caoutchouc (primary use will be in ShareCaou).
  • Provide feedback on how to improve it, bugs that you find...

Why is it called caoutchouc?

Caoutchouc is the name that the indigenous people of South America used for the rubber material that is obtained from vulcanizing latex (the tree sap).

What makes caoutchouc different from plain pandoc?

  • AsciiMath: pandoc doesn't support it, caoutchouc does.
  • LaTeX: caoutchouc supports the direct embedding of LaTeX but pandoc doesn't (it does in an undocumented way which is extremely limited, caoutchouc improves this).
  • Ease of use: ShareCaou makes caoutchouc much easier to use for most people compared to pandoc (which at the very least requires a local installation of pandoc & texlive).

Acknowledgements

  • Pandoc is a fundamental component of caoutchouc.
  • The code used to convert asciimath to latex was taken from here. For more information check the License text in ASCIIMathTeXImg.js.