UPDATED: Rewrite LaTeX letterhead support; ADDED: Start demo folder

Author: fletcher

ToDo.taskpaper

@@ -42,8 +42,8 @@ MultiMarkdown Features:
 		Could write as a very short parent parsing function that only checks for metadata block type?
 	- compatibility mode fails to reject inline links with attributes
 	- Add CriticMarkup accept/reject support @done
-	- Read OPML
-	- Read ITMZ
+	- Read OPML @done
+	- Read ITMZ @done
 
 UX:
 	- Review command line actions
@@ -57,7 +57,7 @@ Performance:
 	- Better to address EOF line match offsets in the re2c regex rather than checking for type == 0 for EVERY line token in the code.
 	- Can I grab ATX Header names as part of the parsing process to avoid having to go back and parse again?  Seems like this could be sped up greatly @done
 	- Remove mmd_node_free and mmd_node_tree_free() @done
-	- mmd_line_scan() is performance hit in recursive blocks (e.g. blockquotes)
+	- mmd_line_scan() is performance hit in recursive blocks (e.g. blockquotes) @done
 		It goes to the end of the line, which is great for typing a line and finding the end at the same time, but unnecessary in recursive line typing...
 
 Code:
@@ -75,13 +75,13 @@ Code:
 
 Export Formats:
 	- LaTeX @done
-	- Beamer/Memoir
-	- OPML
-	- ITMZ
+	- Beamer/Memoir @done
+	- OPML @done
+	- ITMZ @done
 	- OpenDocument
 	- Word
 	- Powerpoint
 	- Pages
 	- Keynote
-	- EPUB
-	- Textbundle
+	- EPUB @done
+	- Textbundle @done

demo/.gitignore

@@ -0,0 +1 @@
+build

demo/assets/test-image.png

@@ -0,0 +1,81 @@
+Title:	A Letter
+Date:	February 28, 2026
+recipient:	A Recipient
+recipient address:	123 Any Street \\ Anytown, USA 12345
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla dolor dolor,
+ultricies nec tellus non, sagittis pellentesque dolor. Proin orci diam,
+aliquet tempor nisl at, tristique iaculis felis. Ut dui felis, pharetra et
+mattis ut, aliquet et quam. Cras sollicitudin justo quam, ac iaculis dolor
+tincidunt nec. Vestibulum scelerisque, urna eu posuere sollicitudin, libero
+purus luctus erat, non sollicitudin arcu lectus a nibh. Nullam tincidunt
+laoreet blandit. Curabitur vitae tincidunt velit. In hac habitasse platea
+dictumst. Maecenas lorem purus, finibus vitae aliquet sed, mattis eget
+mauris. Praesent quam est, finibus ut magna eu, bibendum tempus eros.
+Curabitur aliquam sapien vitae molestie ornare. Donec ac mauris sem.
+
+Duis faucibus risus lorem. Sed purus nisi, finibus ut efficitur quis,
+efficitur eu purus. Ut a ligula pretium, ullamcorper nulla ut, ultricies
+felis. Etiam dapibus dapibus eros, ac aliquet odio rhoncus gravida. Donec nec
+dapibus massa. Donec a leo mollis, convallis eros a, egestas ante. Integer a
+ligula eu ipsum vulputate faucibus sed nec libero. Maecenas quam augue,
+hendrerit ut mauris eu, sagittis vulputate mi. Duis dapibus euismod felis.
+Duis volutpat suscipit ligula a egestas. Aenean pulvinar, ligula et lacinia
+fermentum, lorem magna facilisis nisl, et dignissim mi orci hendrerit mauris.
+Vestibulum bibendum tempor egestas. Duis viverra elit in ex auctor rutrum.
+Pellentesque efficitur nunc eu finibus porttitor. Morbi eu egestas est, a
+egestas eros. Aenean efficitur volutpat dolor quis tempor.
+
+Duis interdum enim vel nulla imperdiet, et aliquet mi fermentum. Duis
+efficitur ante et eros sagittis, cursus aliquam est maximus. Nulla id sapien
+massa. Vestibulum scelerisque pulvinar mi in semper. Nam nibh neque, congue
+id venenatis tincidunt, gravida et eros. Aenean auctor, velit consequat
+fringilla finibus, ligula purus luctus leo, in laoreet diam risus vel diam.
+Nullam imperdiet tortor eget justo semper varius. Suspendisse et molestie
+orci, sed tincidunt elit. Integer condimentum erat et orci commodo
+condimentum. Class aptent taciti sociosqu ad litora torquent per conubia
+nostra, per inceptos himenaeos.
+
+Vivamus mi sem, facilisis quis tellus sit amet, scelerisque congue metus.
+Vestibulum gravida egestas purus nec condimentum. Morbi consectetur, nunc
+quis aliquet semper, libero tortor vehicula metus, dictum tristique mi justo
+quis nisl. Donec varius turpis et sapien mattis, eu interdum tellus
+tincidunt. Integer at interdum ipsum. Suspendisse laoreet sem non nulla
+consectetur mattis. Aliquam ac dui purus. Nullam quam elit, aliquet vel
+consectetur eget, rhoncus eget enim.
+
+Interdum et malesuada fames ac ante ipsum primis in faucibus. Vivamus
+fermentum est in eleifend consequat. In vehicula magna at risus molestie
+blandit. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Duis luctus
+lorem nec elit pharetra, eu pellentesque nulla varius. Curabitur nunc orci,
+tempor in erat vulputate, fermentum elementum nunc. Pellentesque imperdiet
+ligula nec maximus maximus. Aliquam mollis faucibus posuere. Sed lectus
+augue, molestie a tellus et, ullamcorper fringilla tellus. Quisque mauris
+arcu, dapibus ac metus id, finibus vehicula turpis. Interdum et malesuada
+fames ac ante ipsum primis in faucibus. In sit amet vulputate dolor. Aenean
+elit diam, malesuada et dictum id, malesuada eu massa. Etiam ultrices dui
+tortor, eget blandit quam iaculis sit amet. In felis massa, gravida posuere
+ante at, elementum pharetra urna. Nullam vel condimentum elit, in placerat
+mauris.
+
+Praesent tristique, sem at hendrerit iaculis, massa est auctor enim, sit amet
+malesuada justo libero non dolor. Ut elementum velit in semper rhoncus. Etiam
+condimentum, ligula efficitur feugiat consequat, leo dolor vehicula urna, ut
+dictum velit diam a quam. Nullam tincidunt lorem quam, nec maximus libero
+viverra ac. Nulla dapibus cursus nunc non consectetur. Morbi varius, enim
+aliquet dictum tempor, turpis nibh malesuada nisi, sit amet hendrerit ipsum
+risus non quam. Sed dignissim sit amet risus vitae euismod.
+
+Nunc lacinia justo urna, id sollicitudin neque viverra suscipit. Aenean in
+lacinia diam. Mauris tristique tortor vel nisi egestas, dignissim varius
+ligula commodo. Aliquam rutrum ante ante, ut consequat nisi suscipit vitae.
+Curabitur gravida congue commodo. Vivamus neque risus, interdum vitae augue
+ut, volutpat sagittis dui. Donec tincidunt velit nec commodo tincidunt.
+Mauris condimentum tellus vitae facilisis pellentesque. Nulla tempus a quam
+id gravida. Curabitur felis sapien, dapibus vel maximus non, venenatis
+egestas tortor. Maecenas fringilla, purus eget vulputate varius, lorem massa
+tristique dui, id viverra elit libero vitae felis. Mauris maximus ut lorem
+sed aliquam. Donec massa purus, ornare vel ornare sed, laoreet vel ligula.
+Donec viverra turpis cursus arcu eleifend, blandit ornare nunc euismod. Cras
+odio velit, ullamcorper vitae mollis vel, pulvinar id felis. Vestibulum
+pharetra commodo arcu, a dignissim tortor finibus nec.

demo/docs/letter.mmd

@@ -0,0 +1,73 @@
+#!/bin/bash
+
+# Generates each combination of the below
+files=(docs/letter.mmd ../tests/MMD7Tests/Integrated.text)
+# files=(docs/letter.mmd)
+packages=(mmd7-letterhead)
+options=("" "[printed]")
+# options=("")
+addresses=("" "My Street \\\\\\\\ My City, USA  12345")
+# addresses=("")
+returnaddresses=("" "My Other Street \\\\\\\\ My Other City, USA  12345")
+# returnaddresses=("")
+
+
+mkdir -p build
+cp assets/test-image.png build
+
+for file in "${files[@]}"; do
+	base=$(basename "${file}")
+	name=${base%.*}
+
+	for package in "${packages[@]}"; do
+		for option in "${options[@]}"; do
+			for address in "${addresses[@]}"; do
+				if [[ "$address" == "" ]]; then
+					addy=""
+					flags=""
+				else
+					addy="\naddress: $address"
+					flags="a"
+				fi
+				for return in "${returnaddresses[@]}"; do
+					if [[ "$return" == "" ]]; then
+						raddy=""
+					else
+						raddy="\nreturn address: $return"
+						flags+="r"
+					fi
+					echo -e "latexclass: letter\nlatexpackage: $option$package$addy$raddy" | cat - "$file" | ../build/multimarkdown -E -t latex > build/$name-$package-$option-$flags.tex
+				done
+			done
+		done
+	done
+done
+
+cd build
+
+for file in "${files[@]}"; do
+	base=$(basename "${file}")
+	name=${base%.*}
+
+	for package in "${packages[@]}"; do
+		for option in "${options[@]}"; do
+			for address in "${addresses[@]}"; do
+				if [[ "$address" == "" ]]; then
+					flags=""
+				else
+					flags="a"
+				fi
+				for return in "${returnaddresses[@]}"; do
+					if [[ "$return" != "" ]]; then
+						flags+="r"
+					fi
+					latexmk -c "$name-$package-$option-$flags.tex"
+					xelatex "$name-$package-$option-$flags.tex"
+					xelatex "$name-$package-$option-$flags.tex"
+					open "$name-$package-$option-$flags.pdf"
+				done
+			done
+		done
+	done
+done
+

demo/letterhead.sh

@@ -39,7 +39,9 @@
 % If you are using BibTeX, you'll need to change this
 \@ifclassloaded{tufte-handout}{}{
 	\@ifclassloaded{tufte-book}{}{
-		\usepackage[sort&compress,numbers]{natbib}	% Better bibliography support
+		\@ifclassloaded{letter}{}{
+			\usepackage[sort&compress,numbers]{natbib}	% Better bibliography support
+		}
 	}
 }
 
@@ -148,14 +150,18 @@
 		pdfkeywords={\mykeywords}	
 	}
 
-	% Start with a title
-	\AtBeginDocument{
-		\maketitle
-
-		% Show table of contents at the beginning of the document
-		\ifx\showtoc\undefined
-		\else
-			\tableofcontents
-		\fi
+	\@ifclassloaded{letter}{
+		% These don't work with letters
+	}{
+		% Start with a title
+		\AtBeginDocument{
+			\maketitle
+
+			% Show table of contents at the beginning of the document
+			\ifx\showtoc\undefined
+			\else
+				\tableofcontents
+			\fi
+		}
 	}
 }