1

Are there any typographic or formatting conventions for making plain text (a simple *.txt file in ASCII or UTF-8) more readable?

Specific details that I'm considering:

  • when to use hard line breaks
  • how wide should a line be
  • is ALL CAPS OK? when?
  • commonly understood conventions (such as using * for bullets)
  • common mistakes
  • things you might think are OK but can cause issues for specific users

I know there are text only "mark up" languages like Asciidoc and the ubiquitous Markdown. However, these are languages and try to standardize conventions (readability may be accidental in some cases, with preference given to parse-ability). What I'm looking for are things that make a plain text file more readable, which may not necessarily coincide with a mark up language.

2
0

When writing plain text, its pretty hard to specify what is acceptable for line breaks and length. Whoever is reading the text in vim, notepad or browser or whatever may or may not wrap lines.

Typography: There is no bold italic or font choice or size. The font will again depend on whatever is rendering the 'plain text'.

Use * for bullets. They are well recocgnized.

Use ALLCAPS with discretion like everywhere.

Look at how man pages are formatted:

See How to format man pages

As pointed out in the question asciidoc is a markup language. That said it can be converted to beautiful html, pdf, epub, docbook, and yes back to plain text with tools available including pandoc.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.