TXT, Markdown, Word and EPUB: prepare text for publishing
Prepare encoding, blank lines, headings and lists in a chapter draft, then choose Markdown, Word or EPUB and check the result in its intended reader.
Example: turn troubleshooting notes into customer documents
A support team turns a long plain-text troubleshooting note into a customer document. The source contains wrapped paragraphs, numbered commands and an ordered recovery sequence. Removing every number or sorting all lines would destroy meaning even though the output looks cleaner. The first editorial task is deciding which structures are content and which are artifacts of the original export.
Identify paragraphs, lists and commands before cleanup
Keep the source untouched and work on a representative excerpt containing a heading, a list, a URL and a code sample. Confirm encoding before any cleanup. Join wrapped paragraphs only where a newline does not mark a separate record. Add prefixes or new numbering through the line-editing workspace, then compare the transformed excerpt with the source before applying the same settings to the full document.
Choose the output for the recipient’s task
Choose the publication format from the recipient’s next action. Markdown preserves an editable text source, Word helps with collaborative editing, PDF is useful for a fixed handoff, and EPUB needs chapters and navigation for continuous reading. Converting between them does not make those purposes identical. A complex table or embedded object should be tested separately instead of assuming that every exporter will preserve it.
Input: 001, 002, 001 as independent lines. Deduplication should keep the first 001 and 002; sorting is a separate decision.Review in the intended editor or reader
Make the final check in the destination application. Follow links, inspect list nesting and verify that a copied command still matches the original. For an EPUB, traverse the table of contents; for a PDF, inspect page breaks; for Word, verify editable structures. Preserve the source and the processing decisions together so the next revision does not begin by reverse-engineering an exported file.
| Do not rely only on | Also check |
|---|---|
| Readable characters | Check normalization preserves intended distinctions |
| Headings look right | Check heading levels and navigation links |
| An EPUB opens | Check chapter boundaries, cover and reading order |
- Keep a copy in the original encoding and test special characters first.
- Inspect the first and last chapters, lists and blank paragraphs.
- Check the file in the reader used by the recipient.
References
- Text cleanup without losing meaning
Reference for the relevant format and processing rules.
- Markdown publishing across formats
Reference for the relevant format and processing rules.
- EPUB preparation and reading checks
Reference for the relevant format and processing rules.