When writing and editing your book in Pressbooks, you can choose between a default “Visual Editor” which displays your content with shows you much of the styling and formatting you have applied or a “Text Editor” which displays the full HTML structure of your content without any CSS applied.

Use the Visual Editor

The visual editor is the default editor. It is a WYSIWYG (What You See Is What You Get) interface that allows you to see styling and formatting as they are applied. This interface also includes a toolbar that the top of the editor. The visual editor toolbar displays all formatting options by default. You can collapse the second and third rows of tools by clicking the Toolbar toggle button (Shift + Alt + Z) and can move into a ‘Distraction-free writing mode’ by pressing ‘Shift + Alt + W’.

To shift focus to inline toolbar when an image, link, or preview is selected, press ‘Alt + F8`’ (fn + F8 on a Mac); to shift focus to the visual editor menu, press ‘Alt + F9’ (fn + F9 on a Mac); to shift focus to the visual editor toolbar, press ‘Alt + F10’ (fn + F10 on a Mac); and to shift focus to the elements path, press ‘Alt + F11’ (fn + F11 on a Mac). You can also view a set of Keyboard Shortcuts for various keys in the visual editor by pressing ‘Shift + Alt + H’.

Visual toolbar options:

Top row:

1. Paragraph styles dropdown menu: choose from normal paragraph style (Shift + Alt + 7), six different heading styles (Shift + Alt + 1-6), or preformatted text
2. Bold (Ctrl + B)
3. Italics (Ctrl + I)
4. Unordered (bulleted) list (Shift + Alt + U)
5. Ordered (numbered) list (Shift + Alt + O)
6. Blockquote (Shift + Alt + Q)
7. Left-align (Shift + Alt + L)
8. Center-align (Shift + Alt + C)
9. Right-align (Shift + Alt + R)
10. Link (Ctrl + K)
11. Read more (Shift + Alt + T)
12. Toolbar toggle (Shift + Alt + Z)

Second row:

13. Formats dropdown menu: choose from several text indent and tracking options, as well as pullquote options
14. Textboxes dropdown menu: choose from a variety of plain textboxes or predesign educational textboxes (read more here)
15. Underline (Ctrl + U)
16. Strikethrough (Shift + Alt + D)
17. Horizontal line
18. Justify (Shift + Alt + J)
19. Text color
20. Text background color
21. Paste as text
22. Clear formatting
23. Special character
24. Decrease indent
25. Increase indent
26. Undo (Ctrl + Z) and Redo (Ctrl + Y)
27. Keyboard shortcuts guide (Shift + Alt + H)

Bottom row:

28. Tables (read more here)
29. Apply Class
30. Anchor
31. Super^script
32. Sub_script
33. Code (Shift + Alt + X)
34. Footnote^[1]
35. Convert Microsoft Word footnotes
36. LaTeX shortcode
37. Glossary Term

You can highlight a section of existing content and then click a tool on the toolbar to add formatting to that section. Alternatively, select the tool first, and then add new formatted content.

Use the Text Editor

You can also choose to work in a text editor, or switch to it as necessary as needed (to clean up messy HTML for example). The text editor allows you to directly view and edit your book’s HTML content as HTML.

Text Editor Options

The text editor toolbar offers fewer options, tailored to working in HTML. None of the buttons in the HTML editor have keyboard shortcuts, but their functionality is detailed below.

1. Open and close <strong> tags to make text bold (click once to open, and again to close the tag)
2. Open and close <em> tags to make text italics
3. Insert Link text (a pop up will appear)
4. Insert <blockquote> tags
5. Strikethrough text (<del> tags)
6. Insert a date/time tag
7. Insert an image (from URL)
8. Insert an unordered (bulleted) list
9. Insert a ordered (numbered) list
10. Add list item
11. Open and close <code> tags
12. Insert a ‘Read More’ tag (<!--more-->)
13. Close tags (automatically closes any open tags)
14. Insert footnote shortcode

HTML Basics

Pressbooks is designed to make it easy for you to create attractive webbooks and export files without knowing much about book design or web development. Our ability to do this, however, is constrained in many ways by the quality of the underlying ‘markup’ in your book. Pressbooks uses HyperText Markup Language [HTML] to provide the content and structure of your book and Cascading Style Sheets (CSS) to apply the styles that control the appearance of your webbook and export files. You don’t need to know HTML or CSS to use Pressbooks, but understanding a little bit about how they work will help make sure your books look good when you export from Pressbooks.

Here is a brief passage of text with some formatting:

This is what you might write into the VISUAL editor of Pressbooks. But if you look at the TEXT editor, you’ll see that the way that italic and bold is achieved is through “markup”, or HTML. So the markup of that text looks like:

The <em>tag</em> specifies that a text should be italicized. The <strong>tag</strong> specifies that it should be bold.

A reader reading an ebook, or a print book, or a web page won’t see those tags. They are instead used to tell the ebook software, or browser, how those words should look. In addition to the em and strong tags, there are a handful of other basic HTML tags you should know about:

Here is an extended version of the text from above with more HTML tags:

Here is that text with markup:

Write in Markdown

Users who prefer to write using Markdown can do so by activating the Parsedown Party plugin in their book. In networks where this plugin is installed and book admins are able to activate plugins, you can enable a Markdown editor in your book by doing the following:

1. Click Plugins from the left sidebar menu of your book’s dashboard
2. Click Activate on the Parsedown Party plugin
   
3. Open the visual editor for a chapter in your book that you’d like to use Markdown in
4. Click ‘Enable‘ next to the ‘Markdown‘ option in the ‘Status & Visibility‘ menu.

The visual/text editor interface will now be replaced by a simple Markdown-based editor. You can revert the default visual/text editor interface by clicking the Disable button next to the Markdown option in the Status & Visibility menu.