Back to Open Book Shelf

No Offline Access?

Our Open Bookshelf books aren't available in pdf or any e-book format for the following reasons:

Toolchain. Producing readable and well-formatted books on all the various formats would require that we use a more sophisticated toolchain, along the lines that book publishers use. This adds more complexity to our process, which impedes publishing velocity.
Frequent updates. We're constantly updating them with small fixes and tweaks. If we re-generate e-book versions after every fix, that means readers could be reading many different versions at any point in time. We want to avoid this problem and just have one master copy that's online.
Media and links. We consider these natively online books and want to use the full features of webpages in them, including videos and links to other resources. This isn't possible for offline media.

Normal Markdown & GFM

Github Flavored Markdown

**bold**

~~~~strike through~~~~

`single line of code`

Supports Emoji

Code Blocks

You can write code blocks using three backticks (```) followed by the language you want to show. For instance, if you wanted to write a Ruby code block you would write:

```ruby
class Foo
end
```

class Foo
end

You can also leave out the language identifier, doing this will make it so your code isn't highlighted at all, and all text will be white with no coloring.

```
class Bar
end
```

class Bar
end

Highlighting

You may highlight lines within your code blocks. This is a different type of highlighting, and isn't related to how the code within your code block may be colored depending on the language identifier used.
To highlight one or more lines of code, add # highlight on a separate line just before the first line you wish to highlight. To end highlighting, add # endhighlight on a separate line immediately after the last line you wish to highlight.

```ruby
def say_hello_world
# highlight
  puts 'Hello World!!!'
# endhighlight
end
```

def say_hello_world
# highlight
  puts 'Hello World!!!'
# endhighlight
end