Introduction to QText
In the previous section, we mentioned that Text and Large Text Properties are made up of QText and QL. Let's talk a bit about QText first.
QText is a markup language, one of many such. That means that you use it as a way of saying how to format text. Some markup languages are pretty complicated (HTML, the language of the Web, is medium-complexity). QText is adapted from one of the easier and more popular markup languages, Markdown. It doesn't faithfully copy all of Markdown -- we're removing some of Markdown's less-needed details, and adding new ones that seem to be helpful in Querki -- but it follows many of the most common Markdown idioms.
QText is described in detail in the
QText Reference, but here's a table of the features that, in practice, are most often useful in Querki.
What it is | This QText... | ... produces this output |
Emphasis / Italics |
*Surrounded with single asterisks*
|
Surrounded with single asterisks |
Strong / boldface |
**Surrounded with double asterisks**
|
Surrounded with double asterisks |
Paragraphs |
This is the first paragraph.
This is the second paragraph, separated by a blank line.
|
This is the first paragraph. This is the second paragraph, separated by a blank line. |
A run-on paragraph |
This paragraph is made up of
multiple lines, single-spaced. Querki will
squish them into a single paragraph.
|
This paragraph is made up of
multiple lines, single-spaced. Querki will
squish them into a single paragraph. |
Level 1 Header |
# This is a particularly big header
|
This is a particularly big header
|
Level 3 Header (1-6 are available) |
### This is a medium-sized header
|
This is a medium-sized header
|
Bullet Lists |
* Item 1
* Item 2
* Item 3
|
|
Link to another Thing in this Space |
[[Learning Querki]]
|
|
Link to an External Page |
[Google](http://www.google.com/)
|
|
Horizontal Line across the page |
------
|
|
Most of the time, that's really all the QText you need to know; use any of this wherever it seems to make sense in your Large Text Properties, especially in your Default Views. For more details, including the ways in which QText has enhanced Markdown (for instance, syntax to add a div or span for CSS purposes), see the
QText Reference.
(If you know it, you can also use most of HTML. This is useful for formatting that can't be done with QText yet, such as the above table.)