Title of the Article¶ ↑
The is the first paragraph of the Softcover
article template. It shows how to write a document in Markdown, augmented with some custom extensions, including numbered footnotes1 and embedded LaTeX.2
This is the second paragraph, showing how to emphasize text. You can also make text bold.
A section¶ ↑
label{sec:a_section}
This is a section. We'll take a look at some of the features supported by Softcover
.
Source code¶ ↑
In plain Markdown, you can typeset code samples and other verbatim text using four spaces of indentation:
def hello puts "hello, world" end
Softcover
also supports GitHub-style “code fencing” with language-specific syntax highlighting:
# "Hello, world!" in Ruby. def hello puts "hello, world!" end
The second of these can be combined with Softcover's codelisting
environment to make code listings via embedded LaTeX, as shown in Listing~ref{code:hello}.
begin{codelisting} codecaption{Hello, world.} label{code:hello}
# "Hello, world!" in Ruby. def hello puts "hello, world!" end
end{codelisting}
Mathematics¶ ↑
Softcover
supports mathematical typesetting via embedded LaTeX. This includes both inline math, such as ( phi^2 - phi - 1 = 0, ) and centered math, such as [ phi^2 - phi - 1 = 0. ] Softcover
also supports numbered equations via embedded LaTeX, as seen in Eq.~eqref{eq:phi} and Eq.~eqref{eq:gauss}.
begin{equation} label{eq:phi} phi = frac{1+sqrt{5}}{2} approx 1.618 end{equation}
begin{equation} label{eq:gauss} mathbf{nabla}cdotmathbf{B} = 0 qquadmbox{Gauss's law} end{equation}
Images and tables¶ ↑
label{sec:images_and_tables}
This is the second section. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Images¶ ↑
Softcover
supports the inclusion of images, like this:
Using LaTeX\ labels, you can also include a caption (as in Figure~ref{fig:captioned_image}) or just a figure number (as in Figure~ref{fig:figure_number}).
Tables¶ ↑
Softcover
supports raw tables via a simple table syntax:
|HTTP request | URL | Action | Purpose | | GET
| /users | index
| page to list all users | | GET
| /users/1 | show
| page to show user with id 1
| | GET
| /users/new | new
| page to make a new user | | POST
| /users | create
| create a new user | | GET
| /users/1/edit | edit
| page to edit user with id 1
| | PATCH
| /users/1 | update
| update user with id 1
| | DELETE
| /users/1 | destroy
| delete user with id 1
|
Via embedded LaTeX, Softcover
supports table
and tabular
environments as well, as shown in Table~ref{table:figure_placement}.
begin{table} caption{Options for a float placement specifier.label{table:figure_placement}} begin{tabular}{l|l} textbf{Specifier} & textbf{Placement} \ hline kode{h} & Place the float emph{approximately} here \ kode{h!} & Place the float emph{(almost) exactly} here \ kode{t} & Place at the top of the page \ kode{b} & Place at the bottom of the page \ kode{p} & Put on a special page for floats only end{tabular} end{table}
Final section¶ ↑
This is the final section. The previous sections were Section~ref{sec:a_section} and Section~ref{sec:images_and_tables}.
1 Like this.
2 Pronunciations of “LaTeX” differ, but lay-tech is the one I prefer.