IV. Publishing
Plain text begins quietly.
A few characters in a file.
A paragraph.
A chapter.
A manuscript.
Yet writing is rarely meant to remain hidden on the author’s computer. Ideas seek readers. Notes become essays. Essays become books. Research becomes articles. Documentation becomes websites. Lessons become presentations.
This part of The Textsmith Primer explores how plain text leaves the workshop and enters the world.
In earlier parts, we learned that plain text endures, markup gives it structure, and text processing gives it power. Publishing gives it form. It turns carefully crafted source files into books, websites, articles, documentation, presentations, dashboards, and other finished works.
At the heart of this part lies one liberating idea:
Write once. Publish everywhere.
A single source can become many outputs. A manuscript can become a website. A chapter can become a PDF. A lecture can become slides. A research project can become an article, a notebook, and a dashboard. The author does not begin again each time. The publishing system transforms the work.
This is the promise of single-source publishing.
In This Part
28 From Manuscript to Many Formats: The Philosophy of Single-Source Publishing Introduces the idea that one source document can generate many different publication formats.
29 Pandoc: The Universal Document Converter Explores how Pandoc translates between document formats by preserving structure and meaning.
30 Quarto: A Publishing System for the Plain Text Age Shows how Quarto turns plain text projects into books, websites, articles, presentations, and dashboards.
31 Building Websites from Plain Text Examines static site generators and the plain-text workflows behind modern websites.
32 Books Without Word Processors Explores how long-form publishing can thrive without traditional word processors.
33 Academic Publishing: Precision Through Plain Text Shows how citations, bibliographies, equations, and cross references make plain text suitable for scholarship.
34 Publishing Documentation: From Manuals to Living Knowledge Surveys documentation systems such as DocBook, Sphinx, AsciiDoctor, Antora, mdBook, Jupyter, and Quarto.
35 Presentations and Dashboards: Publishing Ideas Visually Demonstrates how slides, speaker notes, handouts, and dashboards can emerge from structured source files.
36 The Publishing Pipeline: From Source to Finished Work Explains the invisible machinery that turns source documents into finished publications.
37 Publishing for the Future Reflects on openness, accessibility, preservation, and the responsibility of communicating with future readers.
Ideas Seeking Readers
Publishing is not merely the production of files.
It is communication.
A good publishing workflow does more than create attractive output. It helps ideas reach the people who need them, in the form that serves them best.
Welcome to the publishing house of the plain text universe.