blob: 258df209d33f93bc94908000df29d002908f0a2c (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
|
---
title: Groffdown
author: Benjamin Chausse
date: 2019-09-19
A markdown to GNU/Troff transpiler
---
What is Groffdown?
------------------
Groffdown aims to take the already existing (and well-known)
markdown syntax and make it compile at speed similar to the
ones of groff. The main compiler for markdown to pdf usually
being `pandoc`, it can be quite long to compile a document (up
to four seconds for one page documents
in some cases) unlike Groff which is known
to usually compile very quickly (0.1 second on average for
one page documents). As a proof of concept, this *README*
pages can be fully compiled using groffdown to then be used by groff.
Example piping workflow
=======================
Groffdown is a script which when run on a markdown document,
will convert the most typical markdown syntax into groff
(using the `ms` macros) to then send it to standard output.
Therefore, it can be piped directly into groff (or
it's related software). Here is an example of a complete piping
command:
- groffdown <filename>.gd | refer -PS -e "-p$REFERBIB" | groff -me -ms -kejpt -T pdf > <filename>.pdf
Syntax goals
============
- Speed
- Markdown Syntax (with yaml preamble)
- LaTeX where markdown lacks
Existing Syntax
===============
Commands similar to markdown
----------------------------
- Headers (1-5)
- *Italic*
- **Bold**
- ***Bold & Italic***
- Bullet points
- `Code blocks (in a monospaced font)`
Commands similar to LaTeX
-------------------------
- Abstract
- Inline equations
- Centered equations
- Citations
Commands similar to YAML
------------------------
- Titles
- Authors
- Dates
- Author's Institution
Current issues
==============
- All text formatings need to be on the same line (you can't start bold
on one line and finish on the other) Doing otherwise seems to trigger
an unescapable recursive loop on the groff side of things.
Needed implementations
======================
- Numbered lists
- multi-macro compatibility (mom macros for urls)
|
