Guide to BBCode Formatting in World Anvil Codex | World Anvil

Guide to BBCode Formatting

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.--

FAQ

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

Additional Resources

Guide to BBCode Commands
Generic article | Jul 28, 2023

Using BBCode to format your text and layout

 

Other guides


Comments

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

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, author, RPG designer, streamer)
  • Grab your hammer and GO WORLDBUILD!
    10 May, 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!

    20 May, 2019 17:13

    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!

    29 Jun, 2019 20:06

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

    7 Jul, 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.

    8 Jul, 2019 18:37

    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!

    21 Aug, 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?

    27 Aug, 2019 23:40

    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!

    Violet Stars
    Violet Hall
    10 Aug, 2020 18:26

    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?

    11 Aug, 2020 01:53

    [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!

    Violet Stars
    Violet Hall
    13 Aug, 2020 21:45

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

    14 Aug, 2020 01:37

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

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