Appendix A — One Document, Many Markup Languages

Markup languages often appear very different when viewed for the first time. HTML uses angle brackets. LaTeX uses commands beginning with backslashes. Markdown relies upon lightweight punctuation. Typst introduces functions. XML emphasizes descriptive tags. AsciiDoc and reStructuredText each have their own conventions.

These differences can make learning a new markup language seem more difficult than it really is.

The purpose of this appendix is to demonstrate that every markup language is describing the same underlying document.

Note that I avoided the temptation of presenting these markup languages as cheatsheets. A cheatsheet quietly says:

“Memorize me.”

A parallel document says:

“Understand me.”

Those are completely different educational philosophies.

The appendix is no longer teaching seven syntaxes.

It is demonstrating one of the central claims of the entire primer:

The structure of a document is more fundamental than the syntax used to express it.

That is exactly how a textsmith learns.

As you compare the examples that follow, pay attention to the structure rather than the syntax.

Notice how each language expresses:

Titles
Headings
Paragraphs
Ordered lists
Unordered lists
Tables
Quotations

The symbols change.

The ideas remain.

Do not try to memorize the syntax.

Instead, understand what each piece of syntax is trying to express.

Once you understand the structure of a document, learning another markup language becomes much easier.

A.1 Sample Document

Education in the Age of Artificial Intelligence

Learning for a New Era

Education has always evolved alongside human civilization. From handwritten manuscripts to printed books, from libraries to the internet, every generation has discovered new ways of preserving and sharing knowledge.

Artificial intelligence represents another important step in that continuing journey. Rather than replacing education, it is changing how people learn, teach, and discover information.

Today, a learner with an internet connection can explore subjects that once required access to large libraries or specialist institutions. This expanding access to knowledge has the potential to benefit communities throughout the world, including those with limited educational resources.

The Changing Role of the Teacher

The role of the teacher is changing from being the sole source of information to becoming a guide, mentor, and facilitator of learning.

Modern teachers increasingly help students to:

Ask thoughtful questions.
Evaluate the reliability of information.
Develop critical thinking skills.
Apply knowledge to real-world problems.
Learn responsibly with artificial intelligence.

Knowledge remains important, but the ability to understand and apply knowledge has become even more valuable.

The Changing Role of Students

Students are no longer expected merely to remember information.

They are encouraged to become active participants in their own education by cultivating habits such as:

Curiosity
Independent learning
Collaboration
Responsible use of artificial intelligence
Lifelong learning
Digital literacy

These habits prepare learners not only for examinations but also for continuous learning throughout their lives.

Opportunities Created by Artificial Intelligence

Area	Contribution
Accessibility	Learners can access educational resources regardless of geographical location.
Personalization	Learning materials can be adapted to individual needs and learning pace.
Translation	Educational content can be made available in many different languages.
Availability	Learning can continue beyond the classroom at any time of day.
Assistance	Students receive explanations, examples, and guided practice while studying.

A Thought to Remember

Artificial intelligence does not diminish the importance of education. It increases the importance of learning how to think, ask better questions, and use knowledge wisely.

Conclusion

Every major technological advance has changed education without changing its central purpose.

The goal of education remains the same: to cultivate understanding, wisdom, and the ability to contribute positively to society.

Artificial intelligence is another powerful tool in that continuing story. Used thoughtfully, it expands opportunities for learners, supports teachers in their work, and helps make knowledge more accessible to communities throughout the world.

The challenge for future generations is not whether artificial intelligence will become part of education—it already has. The greater challenge is learning how to use it wisely, responsibly, and in ways that strengthen both human understanding and human flourishing.

A.2 Sample document in parallel Representations

Below, a representative version of the sample document in each language is shown in its abbreviated form. What is important here is to show how each language represents the above document.

A.2.1 Markdown

# Education in the Age of Artificial Intelligence

## Learning for a New Era

Education has always evolved alongside human civilization...

## The Changing Role of the Teacher

1. Ask thoughtful questions.
2. Evaluate information.
3. Develop critical thinking.
4. Apply knowledge.
5. Learn responsibly with AI.

## The Changing Role of Students

- Curiosity
- Independent learning
- Collaboration
- Responsible AI use
- Lifelong learning

## Opportunities Created by Artificial Intelligence

| Area | Contribution |
|------|--------------|
| Accessibility | Learning anywhere |
| Personalization | Adaptive lessons |
| Translation | Multiple languages |
| Availability | Learning anytime |
| Assistance | Guided practice |

> Artificial intelligence does not diminish education.
> It increases the importance of thoughtful learning.

## Conclusion

The goal of education remains the cultivation of understanding.

A.2.2 HTML

<!DOCTYPE html>
<html>
<head>
  <title>Education in the Age of Artificial Intelligence</title>
</head>
<body>

<h1>Education in the Age of Artificial Intelligence</h1>

<h2>Learning for a New Era</h2>

<p>Education has always evolved alongside human civilization...</p>

<h2>The Changing Role of the Teacher</h2>

<ol>
  <li>Ask thoughtful questions.</li>
  <li>Evaluate information.</li>
  <li>Develop critical thinking.</li>
  <li>Apply knowledge.</li>
  <li>Learn responsibly with AI.</li>
</ol>

<h2>The Changing Role of Students</h2>

<ul>
  <li>Curiosity</li>
  <li>Independent learning</li>
  <li>Collaboration</li>
  <li>Responsible AI use</li>
  <li>Lifelong learning</li>
</ul>

<table>
<tr><th>Area</th><th>Contribution</th></tr>
<tr><td>Accessibility</td><td>Learning anywhere</td></tr>
<tr><td>Personalization</td><td>Adaptive lessons</td></tr>
</table>

<blockquote>
Artificial intelligence does not diminish education.
</blockquote>

<h2>Conclusion</h2>

<p>The goal of education remains the cultivation of understanding.</p>

</body>
</html>

A.2.3 XML

Here XML becomes descriptive rather than presentational. We invent our own vocabulary to express the document’s structure.

<?xml version="1.0" encoding="UTF-8"?>

<education-article>

  <title>Education in the Age of Artificial Intelligence</title>

  <section id="learning">
    <heading>Learning for a New Era</heading>

    <paragraph>
      Education has always evolved alongside human civilization...
    </paragraph>
  </section>

  <section id="teachers">

    <heading>The Changing Role of the Teacher</heading>

    <ordered-list>
      <item>Ask thoughtful questions.</item>
      <item>Evaluate information.</item>
      <item>Develop critical thinking.</item>
      <item>Apply knowledge.</item>
      <item>Learn responsibly with AI.</item>
    </ordered-list>

  </section>

  <section id="students">

    <heading>The Changing Role of Students</heading>

    <unordered-list>
      <item>Curiosity</item>
      <item>Independent learning</item>
      <item>Collaboration</item>
      <item>Responsible AI use</item>
    </unordered-list>

  </section>

  <quotation>
    Artificial intelligence does not diminish education.
  </quotation>

  <conclusion>
    The goal of education remains the cultivation of understanding.
  </conclusion>

</education-article>

A.2.4 LaTeX

\documentclass{article}
\title{Education in the Age of Artificial Intelligence}

\begin{document}

\maketitle

\section{Learning for a New Era}

Education has always evolved alongside human civilization...

\section{The Changing Role of the Teacher}

\begin{enumerate}
\item Ask thoughtful questions.
\item Evaluate information.
\item Develop critical thinking.
\item Apply knowledge.
\item Learn responsibly with AI.
\end{enumerate}

\section{The Changing Role of Students}

\begin{itemize}
\item Curiosity
\item Independent learning
\item Collaboration
\item Responsible AI use
\end{itemize}

\begin{tabular}{ll}
Area & Contribution\\
Accessibility & Learning anywhere\\
Personalization & Adaptive lessons
\end{tabular}

\begin{quote}
Artificial intelligence does not diminish education.
\end{quote}

\section{Conclusion}

The goal of education remains the cultivation of understanding.

\end{document}

A.2.5 Typst

#set page(numbering: "1")

#heading(level: 1)[Education in the Age of Artificial Intelligence]

#heading(level: 2)[Learning for a New Era]

Education has always evolved alongside human civilization...

#heading(level: 2)[The Changing Role of the Teacher]

+ Ask thoughtful questions.
+ Evaluate information.
+ Develop critical thinking.
+ Apply knowledge.
+ Learn responsibly with AI.

#heading(level: 2)[The Changing Role of Students]

- Curiosity
- Independent learning
- Collaboration
- Responsible AI use

#table(
  columns: 2,
  [Area], [Contribution],
  [Accessibility], [Learning anywhere],
  [Personalization], [Adaptive lessons],
)

#quote[
Artificial intelligence does not diminish education.
]

#heading(level: 2)[Conclusion]

The goal of education remains the cultivation of understanding.

A.2.6 reStructuredText

=========================================
Education in the Age of Artificial Intelligence
=========================================

Learning for a New Era
======================

Education has always evolved alongside human civilization...

The Changing Role of the Teacher
================================

#. Ask thoughtful questions.
#. Evaluate information.
#. Develop critical thinking.
#. Apply knowledge.
#. Learn responsibly with AI.

The Changing Role of Students
=============================

* Curiosity
* Independent learning
* Collaboration
* Responsible AI use

+----------------+---------------------+
| Area           | Contribution        |
+================+=====================+
| Accessibility  | Learning anywhere   |
+----------------+---------------------+

    Artificial intelligence does not diminish education.

Conclusion
==========

The goal of education remains the cultivation of understanding.

A.2.7 AsciiDoc

= Education in the Age of Artificial Intelligence

== Learning for a New Era

Education has always evolved alongside human civilization...

== The Changing Role of the Teacher

. Ask thoughtful questions.
. Evaluate information.
. Develop critical thinking.
. Apply knowledge.
. Learn responsibly with AI.

== The Changing Role of Students

* Curiosity
* Independent learning
* Collaboration
* Responsible AI use

|===
|Area |Contribution

|Accessibility
|Learning anywhere

|Personalization
|Adaptive lessons

|===

____
Artificial intelligence does not diminish education.
____

== Conclusion

The goal of education remains the cultivation of understanding.

A.3 Comparing the Languages

At first glance these seven documents appear very different. One uses angle brackets, another commands, another punctuation, another functions. Yet each expresses exactly the same structure: a title, headings, paragraphs, lists, a table, a quotation, and a conclusion.

That is the central lesson of this appendix.

Do not memorize the syntax. Understand the structure.

Once you understand the structure of a document, learning a new markup language becomes less like learning a new subject and more like learning another dialect of the same language.