Raw Codes

@Body:You probably think my email program has gone wacko, inserting codes rather than applying formatting. But it hasn’t. I’m just trying the technique described in this article–marking formatting with raw codes. Why would anyone want to do that? Consider this:

@ListFirst:1.Text formatting is misleading. It may look nice, but it comes with a price–the sacrifice of structure and control to appearance. Is your heading formatted with Heading 2 paragraph style, or is it formatted directly as Arial 14-point bold? The difference may not be immediately apparent. With codes, you know.

@ListMiddle:2.Using codes forces you to resist the “easy fix” of directly applied formatting. Come on, admit it: You sometimes center a heading with CTRL + e rather than modifying the paragraph style as you should. I know I do. But if I use raw codes, I don’t even have to think about it. I just enter “@Heading 3:” and start typing away. My guilty feelings are gone (sob!).

3.Using codes is just plain easier than mucking about with styles and fonts and formats all the time. It’s a simpler way to live. Try it! You might be surprised at how much you like it. If you’re really going to make the attempt, you might want to record macros that insert your most common codes and then assign those macros to toolbar buttons or keyboard combinations.

4.Using codes for special characters means there’s no more worrying about conversion problems from platform to platform.

5.Using codes ensures greater consistency from document to document–at least it does if you keep using the same codes. Ensuring consistency of styles is more difficult. Which ones are yours? Which ones did Word sneak in when you weren’t looking? BodyTextUgly? Where did that come from?

6.Using codes makes it easy to tag your text by function and structure rather than by appearance. For example, instead of using a Heading 1 style, you can tag your text as @ChapterHead:, which actually says what your text is being used for.

7.Using codes means you can work in a simple text processor when you don’t have access to Microsoft Word.

8.Using codes makes your formatting human readable! That’s pretty remarkable, when you consider all of the hidden, proprietary formatting systems in the world.

@ListLast:9.Using codes makes it easy to translate your formatting into a variety of other formats: HTML. XML. Even Microsoft Word.

@Body:”And how,” you ask, “can I turn codes into Microsoft Word formatting?” With our RazzmaTag program, which you can learn more about here:


One of the most popular academic typesetting programs, TeX, is built around the concept of working directly with codes and then applying formatting based on those codes. Other programs, too, can import coded documents, including QuarkXPress, PageMaker, and FrameMaker, and many publishers take advantage of that fact, asking their editors to work directly with codes. If you’ve never considered this possibility, now you can add it to your bag of tricks.



Allin Cottrell provides an excellent and informative rant on the whole subject of separating content from presentation. You’ll find it here:


A good place to learn more about TeX (which, by the way, is *free*) is the TeX User Group Home Page:


Yes, it is possible to “reveal codes” in Microsoft Word. Interested? Check out CrossEyes, from Levit & James:


This entry was posted in Editing. Bookmark the permalink. Post a comment or leave a trackback: Trackback URL.

Post a Comment

You must be logged in to post a comment.

  • The Fine Print

    Thanks for reading Editorium Update (ISSN 1534-1283), published by:


    Articles © on date of publication by the Editorium. All rights reserved. Editorium Update and Editorium are trademarks of the Editorium.

    You may forward copies of Editorium Update to others (but not charge for it) and print or store it for your personal use. Any other broadcast, publication, retransmission, copying, or storage, without written permission from the Editorium, is strictly prohibited. If you’re interested in reprinting one of our articles, please send an email message to editor@editorium.com

    Editorium Update is provided for informational purposes only and without a warranty of any kind, either express or implied, including but not limited to implied warranties of merchantability, fitness for a particular purpose, and freedom from infringement. The user (you) assumes the entire risk as to the accuracy and use of this document.

    The Editorium is not affiliated with Microsoft Corporation or any other entity.

    We do not sell, rent, or give our subscriber list to anyone.