.\"t
.\" Automatically generated by Pandoc 2.9.2.1
.\"
.TH "md2term" "1" "" "" "General Use Manual"
.hy
.SS NAME
.PP
md2term - Markdown parser for highlights and colors in terminal.
.SS DESCRIPTION
.PP
\f[C]md2term\f[R] was created to be a markdown parser for short texts
(less than 30 lines) that could be used in terminal presentations
(\f[I]text slides\f[R]) and, at the same time, able to be correctly
visualized by other parsers on websites (GitHub, GitLab, etc).
The script can also be used satisfactorily to view other texts in
markdown, as long as its limitations are observed.
.SS SYNOPSIS
.PP
md2term [OPTIONS] -f FILE
.SS OPTIONS
.PP
-b CHARACTER\ \ \ List marker character.
.PP
-c\ \ \ \ \ \ \ \ \ \ \ \ \ Clears the terminal before displaying text.
.PP
-i SPACES\ \ \ \ \ Indentation of lists, codes and citations in spaces.
.PP
-k VALUE\ \ \ \ \ \ \ Keep hash marks in titles:
.PP
\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 0=Discard all 1=Keep all 2=Only in title 1
.PP
-m SPACES\ \ \ \ \ Ident from left margin in spaces.
.PP
-p\ \ \ \ \ \ \ \ \ \ \ \ \ Load a pager (less).
.PP
-s FILE\ \ \ \ \ Alternative color scheme.
.PP
-t LINES\ \ \ \ \ \ Top offset in lines.
.PP
-h\ \ \ \ \ \ \ \ \ \ \ \ \ Show this help.
.SS VALID MARKINGS
.PP
.TS
tab(@);
l l.
T{
Marking
T}@T{
Output
T}
_
T{
\f[C]**TEXT**\f[R] or \f[C]__TEXT__\f[R]
T}@T{
BOLD
T}
T{
\f[C]*TEXT*\f[R] or \f[C]*TEXT*\f[R]
T}@T{
ITALIC
T}
T{
\f[C]___TEXT___\f[R] or \f[C]***TEXT***\f[R]
T}@T{
BOLD AND ITALIC
T}
T{
\f[C]\[ti]\[ti]TEXT\[ti]\[ti]\f[R]
T}@T{
STRIKETHROUGH
T}
T{
\f[C]<u>TEXT</u>\f[R]
T}@T{
UNDERLINE
T}
T{
\f[C]\[ga]TEXT\[ga]\f[R]
T}@T{
CODE IN LINE
T}
T{
\f[C][LABEL](URL)\f[R]
T}@T{
LABEL
T}
.TE
.SS BLOCKS
.PP
Code blocks must be marked at the beginning of the line!
.SS Code block
.IP
.nf
\f[C]
\[ga]\[ga]\[ga]
CODE BLOCK
\[ga]\[ga]\[ga]
\f[R]
.fi
.SS Unordered lists
.IP
.nf
\f[C]
- Item 1
- Item 2
- Item 3
\f[R]
.fi
.SS Ordered lists
.IP
.nf
\f[C]
1. Item 1
1. Item 2
1. Item 3
\f[R]
.fi
.SS Quotes/notes
.IP
.nf
\f[C]
> The text of the quote or note.
\f[R]
.fi
.SS Force line break
.IP
.nf
\f[C]
Paragraphs, list items, and quotes can \[rs]
have lines broken where desired \[rs]
using backslashes.
\f[R]
.fi
.SS LIMITATIONS
.IP \[bu] 2
Does not interpret nested lists (sub-items) correctly.
.IP \[bu] 2
Long line breaks can happen in the middle of words, but you can work
around the problem by specifying where they should happen in the source
text (this is a valid GFM markdown markup).
.IP \[bu] 2
Using the \f[C]-c\f[R] and \f[C]-p\f[R] options together can lead to
buffer redraw problems in \f[C]less\f[R].
.IP \[bu] 2
Links are just visual representations using the markup label (not the
URL).
If you prefer the URL, it can be used as a label or written as plain
text (most terminals interpret URLs as links).
.SS LICENSE
.PP
Copyright (C) 2022 Blau Araujo <blau@debxp.org>
.PP
GPLv3+ License: GNU GPL version 3 or later
<https://gnu.org/licenses/gpl.html>
.PD 0
.P
.PD
This is free software: you are free to change and redistribute it.
.PD 0
.P
.PD
THERE IS NO WARRANTY, to the fullest extent permitted by law.
.PP
Developed by Blau Araujo and Romeu Alfa