user-guide.log

mdpre Markdown Preprocessor v1.1.5+ (3 April, 2026)
===================================================

Cheetah templating engine imported

- opened <stdout> for writing
Def makefile = file-3

Def logfile = stderr

Def output = stdout

Def input = stdin

Def node = Mac.domain_not_set.invalid

Def version = Darwin Kernel Version 25.4.0: Thu Mar 19 19:30:44 PDT 2026; root:xnu-12377.101.15~1/RELEASE_ARM64_T6000

Def architecture = 64bit Mach-O

Def machine = arm64

Def system = Darwin

Def release = 25.4.0

Def python_version = 3.14.3

Def python_implementation = CPython

Def processor = arm

Def mdpre_date = 3 April, 2026

Def mdpre_level = 1.1.5+

Def userid = martinpacker

Def day = 3

Def month = April

Def year = 2026

Def time = 14&colon;47

Def date = 3 April&comma; 2026

Def TOC = Table Of Contents

Markdown Preprocessor User Guide

Table Of Contents - spec '2 * Table Of Contents'

2 5 Table Of Contents
.....  Why A Preprocessor?

.....  How Do You Use mdpre?

..... .....  Help

..... .....  Printing The Version

..... .....  Verbose Mode

..... .....  Creating A Make File Fragment

..... .....  Defining Variables

..... .....  Filenames

..... .....  Specifying Filenames On The Command Line

..... .....  TextBundle And TextPack Support

..... .....  Processing Flow

..... .....  Installing Cheetah 3 Template Support

.....  Language Elements

..... .....  Comments with `=.`

..... .....  Including files with `=include`

..... .....  Defining Variables With `=def`

..... ..... .....  Substituting Variables In Text

..... .....  Undefining Variables With `=undef`

..... .....  Incrementing Integer Variables Wth `=inc`

..... .....  Decrementing Integer Variables Wth `=dec`

..... .....  Conditional Inclusion 

..... ..... .....   `=ifdef` And `=ifndef`

..... ..... .....   `=ifempty` And `=ifnotempty`

..... ..... .....   `=ifmatch` And `=ifnotmatch`

..... .....  Converting A CSV File To A Markdown Table With `=csv` And `=endcsv`

CSV Start

CSV Stop

..... ..... .....  Controlling Table Alignment With `=colalign`

Column Alignment - spec 'l r r'

CSV Start

CSV Stop

..... ..... .....  Controlling Table Column Widths With `=colwidth`

..... ..... .....  Applying A CSS Class To Whole Rows With `=rowspan`

..... ..... .....  Applying A CSS Class To Cells Based On Rules  With `=csvrule`

..... ..... .....  Some Useful CSS And Javascript Examples With `=rowspan` and `=csvrule`

..... ..... ..... .....  Colouring The Cell's Text With CSS

..... ..... ..... .....  Colouring The Cell's Background With CSS

..... ..... ..... .....  Alerting Based On A Cell's Class With Javascript

..... ..... .....  Flowing A Table - To Shorten And Widen It - With `=csvflow`

..... .....  Creating A Calendar Month Table With `=cal`

Calendar Start

Calendar Day Span

Calendar Day Span

Calendar Class Days

Calendar Class Days

Calendar Days Note

Calendar Days Note

Calendar Days Note

Calendar Stop

..... ..... .....  Controlling How Day Numbers Are Displayed With `=caldays`

..... ..... .....  Adding A Key To The Day Numbers' Styling With `=calkey`

..... ..... .....  Adding Information To A Cell With `=calnote`

..... .....  Concatenating Lines With `\`

..... .....  Generating A Table Of Contents With `=toc`

..... .....  Terminating Input With `=stop`

..... .....  Using Cheetah 3 Templates

..... ..... .....  Defining Templates With `=template`

..... ..... ..... .....  Defining A Template With Inline Text

..... ..... ..... .....  Defining A Template With An External File

..... ..... .....  Using A Template With `=usetemplate`

.....  Additional Information

..... .....  Built-In Variables

Column Alignment - spec 'l l l'

Column Width - spec ' 2 4 1'

CSV Start

CSV Stop

CSV Start

CSV Stop

---------------------------------------------------
- Processing completed.
---------------------------------------------------