---
title: |
 Processing Markdown Text
 That Contains Context Annotations
subtitle: Semantic Markdown Implemented as a Plugin for Pandoc and Quarto

date: 2025-05-27

toc-depth: 2

format:
  stylish-report-pdf:
    pdfversion: "2.0"
    pdfstandard: [A-4f, UA-2]

# generate Well-Tagged PDF using tag tagging
# requires documentmetadatasupport 1.0n (2025-03-25)
#    tagging: on
# else generate Well-Tagged PDF using latest testphase components
# <https://latex3.github.io/tagging-project/documentation/prototype-usage-instructions>
# requires documentmetadatasupport 1.0k (2024-12-21)
    pdftestphase: latest

# fail on error generating Well-Tagged PDF
#    pdftestphasestrict: true

# debugging of Well-Tagged PDF
#    pdfdebug: ["para"]

metadata-files:
  - _actors.yml
keywords:
  - Markdown
  - Commonmark
  - Lua
  - pandoc
  - text editor
  - semantic publishing

link-citations: true
bibliography: ref.bib
csl: apa
resource-path:
- /usr/share/citation-style-language/styles

filters:
  - include-code-files

# fix british spelling
include-in-header:
- text: |
    \makeatletter
    \@namedef{doclicense@lang@word@license}{ licence}
    \makeatother

#keep-tex: true
---

# Abstract

*FIXME and TODO notes in cursive text (like this)
are editorial notes not intented for inclusion in the final delivery.*

# Introduction

{{< include _intro.qmd >}}

# Analysis of existing framework

{{< include _background.qmd >}}

# Product requirements

{{< include _constraints.qmd >}}

# Design choices

{{< include _design.qmd >}}

# Usage

{{< include _usage.qmd >}}

# Evaluation

{{< include _evaluation.qmd >}}

# Conclusion

{{< include _conclusion.qmd >}}

# Bibliography {.appendix}

\begingroup
\raggedright
::: {#refs}
:::
\endgroup

\appendix

# Pandoc filter plugin {.appendix}

```{.lua include="_extensions/ruc-play/semantic-markdown/semantic-markdown.lua" code-line-numbers="true"}
```