Formatting Hints in World Anvil Codex | World Anvil

Formatting Hints

Restructuring the Codex

We are currently moving articles around and changing the general structure of the Codex. Please come back later if you get lost!

How to format awesome articles

Written by Ademal

Formatting Principles

Formatting is a science, not an art. Formatting boils down the the ability to control where a user's eye goes, to intrigue them by illustration and to hold them with bite-sized pieces of information which encourage them to devour the entire article up.
 
There's 4 key points to consider when Formatting for WorldAnvil. Don't worry about them until you've written out your article's text. Formatting should be the last thing you do. As you get more of an eye for it you'll start doing it earlier into your process. Until then, don't make it harder on yourself by mixing the two.
Informative Vs. Narrative
Read your content. How much is Informative? How much is Narrative? Informative text is text which is more factual than flavorful. Narrative text is more like a snippet from a story, or a quote.

Try to not interweave the two. Have your informational content be clear, concise, and without repetition, and allow your narrative text to illustrate the information and ground it into the world.
Illustration
There's stead in the old saying that a picture is worth a thousand words. Use illustration and consider what those 1000 words are. Avoid describing something a picture already shows unless needed. Save the screen estate.
Line Width and Columns
The more an eye has to move horizontally while reading, the more likely it is to lose its place. Save full-width blocks of text for longform quotes or short blurbs of information. Try to think how to organize everything else into helpful columns where you can.
Justification
This goes hand-in-hand with Columns. Justification will make your text have an even edge to it. This helps the eye digest the page as a grid of morsels to read over and devour.

Be warned: justification takes work to make it look good. If you want to prevent words from being oddly spaced you will need to rewrite sections over and over to make sure the line breaks happen at that perfect point.
 

Formatting Examples

 

Centered Columns

Going forward it will now be a mandatory requirement that you credit the artists whose images you use- even if you yourself are the artist who created the image; don't credit your artists? Your article can no longer be featured- and will no longer be eligible to win competitions!
  Support for minor Image manipulation is planned, but for now you can use a centered column to center an image.  

Example

 

Execution

[concol][img:8082][/concol]
 

Image Columns

Going forward it will now be a mandatory requirement that you credit the artists whose images you use- even if you yourself are the artist who created the image; don't credit your artists? Your article can no longer be featured- and will no longer be eligible to win competitions!
  Use image columns to put flavorful illustration into your writing and to manage your line width.  

Example

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum in turpis eu augue efficitur auctor. Fusce venenatis maximus magna in accumsan. Sed sed malesuada urna. Etiam eget semper lorem. Aenean purus ante, mattis non turpis id, molestie efficitur purus. Quisque tincidunt est dui. Cras hendrerit ornare quam a cursus. Etiam et sapien dictum, ultrices nisl vitae, bibendum enim. Integer luctus at lorem sit amet aliquam. Sed at mauris at metus efficitur imperdiet. Aenean ultricies sem leo, at tristique turpis vulputate sit amet.

Curabitur luctus purus eget eros consequat finibus. Pellentesque eu efficitur dolor. Fusce in venenatis diam. Pellentesque non eros viverra diam malesuada lobortis eu a velit.
 

Execution

[row]   [col]Text[/col]   [col][img:8082][/col]   [/row]
 

Quotes

Use quotes to mark narrative sections of your article told from within the context of the setting itself.  

Example

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum in turpis eu augue efficitur auctor. Fusce venenatis maximus magna in accumsan. Sed sed malesuada urna. Etiam eget semper lorem. Aenean purus ante, mattis non turpis id, molestie efficitur purus. Quisque tincidunt est dui. Cras hendrerit ornare quam a cursus. Etiam et sapien dictum, ultrices nisl vitae, bibendum enim. Integer luctus at lorem sit amet aliquam. Sed at mauris at metus efficitur imperdiet. Aenean ultricies sem leo, at tristique turpis vulputate sit amet.

Curabitur luctus purus eget eros consequat finibus. Pellentesque eu efficitur dolor. Fusce in venenatis diam. Pellentesque non eros viverra diam malesuada lobortis eu a velit. Nulla porta iaculis placerat. Duis elit risus, aliquet ut auctor ut, varius porta dui. Curabitur quis ante purus.

Donec et vulputate odio, eu pellentesque tellus. Aenean at mollis lorem.
— AuthorName
 

Execution

[quote]Text|Author[/quote]
Everything after the vertical line becomes the author credit.  

Longform Quotes

  Use Longform Quotes for when the Quote tag is just a bit too blatant or spacious for your text, or when you're putting a substantial amount of text into your article.  

Example

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum in turpis eu augue efficitur auctor. Fusce venenatis maximus magna in accumsan. Sed sed malesuada urna. Etiam eget semper lorem. Aenean purus ante, mattis non turpis id, molestie efficitur purus. Quisque tincidunt est dui. Cras hendrerit ornare quam a cursus. Etiam et sapien dictum, ultrices nisl vitae, bibendum enim. Integer luctus at lorem sit amet aliquam. Sed at mauris at metus efficitur imperdiet. Aenean ultricies sem leo, at tristique turpis vulputate sit amet.

Curabitur luctus purus eget eros consequat finibus. Pellentesque eu efficitur dolor. Fusce in venenatis diam. Pellentesque non eros viverra diam malesuada lobortis eu a velit. Nulla porta iaculis placerat. Duis elit risus, aliquet ut auctor ut, varius porta dui. Curabitur quis ante purus.

Donec et vulputate odio, eu pellentesque tellus. Aenean at mollis lorem. In hac habitasse platea dictumst. Suspendisse faucibus at orci at consequat. Nullam faucibus eget magna eget sodales. Proin gravida ex ac felis iaculis, ut pellentesque purus viverra. Aenean non feugiat eros. Sed ornare dictum eros sed rutrum. Proin id accumsan tellus, id ultricies magna. Aliquam erat volutpat. Sed ultricies, massa convallis convallis tempus, ipsum lorem euismod eros, at viverra purus orci vel quam. Aliquam et pharetra enim. Praesent ornare, odio quis hendrerit aliquet, ligula neque vulputate metus, sit amet viverra quam risus ac leo. Aliquam varius, metus vel congue volutpat, velit dui mattis nisl, ultrices cursus arcu turpis tempor nulla. Vivamus facilisis aliquam lacus, eu consequat lacus vestibulum tempor. Donec id nulla condimentum libero mattis cursus.
—Author Name

Duis pulvinar pellentesque lobortis. Etiam vel elementum orci. Suspendisse viverra, dolor et elementum egestas, arcu tellus posuere eros, aliquet tincidunt lectus mi at nunc. Quisque metus mauris, faucibus vitae mi sed, elementum facilisis nulla. Cras ac justo mattis, suscipit eros in, feugiat velit. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Nam ultrices sodales felis sed pretium. Maecenas eu lacus eu mi congue mattis eget a metus. Maecenas porttitor nisl tellus, sit amet consectetur enim elementum id. Aliquam erat volutpat. Vestibulum at suscipit arcu, vestibulum ultricies urna. Orci varius natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus.
 

Execution

Text   [hr]   [i]Quoted Text[/i]   [right][i]—Author Name[/i][/right]   [hr]   Standard Text

Key/Value Pairs

Use Key/Value Pairs to create listed items with small headers.
 

Example

Lorem ipsum
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum in turpis eu augue efficitur auctor.
 

Execution

--Lorem ipsum::Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum in turpis eu augue efficitur auctor.--

Navigation

FAQ

Why did all my content go wonky?
Check for unclosed [col], [justify], [left], [right], [center], [ul], [ol], [li], [h], or [noparse] tags.

Comments

Please Login in order to comment!
May 30, 2018 10:01 by Janet Forbes

This is so useful! Thanks so much for creating it, Ademal! hurries off to make a tutorial based on the above content

  • Janet Forbes (Founder of World Anvil, fantasy author and RPG designer)
  • Grab your hammer and GO WORLDBUILD!
    May 10, 2019 00:46

    I don't recall where I learned the
    command (line break) - but why is it not described on this page? I'd like to find a short cut for a comprehensive list for formatting commands. Looking forward to getting to know this tool!

    May 20, 2019 17:13 by Ademal

    Here is the list of BBCode commands, and there's another off to the right of the article editing page!

    Check out my summercamp by going here and checking out any of my gold-star articles!

    Jun 29, 2019 20:06

    thank you , I was searching about images with text finally found what I was looking for

    Jul 7, 2019 15:31

    But is there a way to just hit enter once and actually have the text on be the next line? Seriously, it's the most annoying "feature" World Anvil has. You either have to have a line in between blocks of text, or have everything be one paragraph. Makes it very difficult to format my articles the way I want them and still have them look good.

    Jul 8, 2019 18:37 by Ademal

    I'm looking into it. I believe a WYSIWYG editor is planned for the future.   Right now, no, I don't think there's a way to do it with a simple enter key, but wrapping things in [in][/in] will get the aesthetic you want for now.


    Example

    [in]Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam vitae ultricies nulla. Fusce et rhoncus ex. Aenean erat justo, mattis at urna ac, viverra condimentum sapien. Proin quis augue eu massa rutrum consequat eget non libero. Quisque sit amet massa urna.[/in] [in]Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam vitae ultricies nulla. Fusce et rhoncus ex. Aenean erat justo, mattis at urna ac, viverra condimentum sapien. Proin quis augue eu massa rutrum consequat eget non libero. Quisque sit amet massa urna.[/in]
    |-<>-|
    Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam vitae ultricies nulla. Fusce et rhoncus ex. Aenean erat justo, mattis at urna ac, viverra condimentum sapien. Proin quis augue eu massa rutrum consequat eget non libero. Quisque sit amet massa urna.
    Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam vitae ultricies nulla. Fusce et rhoncus ex. Aenean erat justo, mattis at urna ac, viverra condimentum sapien. Proin quis augue eu massa rutrum consequat eget non libero. Quisque sit amet massa urna.

    Check out my summercamp by going here and checking out any of my gold-star articles!

    Aug 21, 2019 19:32

    I'm attempting to use key/value pairs to format text in a sidebar, as in repeated headings and values -- but I'm running into the issue that this works perfectly with only one key/value pair, but if I try to line break and add another, it breaks. Any tips?

    Aug 27, 2019 23:40 by Ademal

    I advise using
    within them instead.   --Key::Value1[br]Value2--

    Check out my summercamp by going here and checking out any of my gold-star articles!

    Aug 10, 2020 18:26 by Violet Hall

    I'm trying to make three separate columns with my article, but for some reason my third block of text is below my first one. Does anyone know how to fix this?

    Aug 11, 2020 01:53 by Ademal

    [row] [col3]Content[/col] [col3]Content[/col] [col3]Content[/col] [/row]   Is that the code you're using?

    Check out my summercamp by going here and checking out any of my gold-star articles!

    Aug 13, 2020 21:45 by Violet Hall

    No, actually! I was unaware that you needed to put a three there! Thanks so much for your help!

    Aug 14, 2020 01:37 by Ademal

    Yep! Otherwise it's a 2-column split.

    Check out my summercamp by going here and checking out any of my gold-star articles!