The Verso exploration
This is a Verso exploration.
1. Basic
In Verso, we can use simple Markdown syntax. But not all usual Markdown syntax are supported.
1.1. h1 Heading
1.1.1. h2 Heading
1.1.1.1. h3 Heading
1.1.1.1.1. h4 Heading
❌
##### h5 Heading ###### h6 Heading
1.1.2. Horizontal Rules
❌
-------------------------
1.1.3. Typographic replacements
❌
(c) (C) (r) (R) (tm) (TM) (p) (P) +- test.. test... test..... test?..... test!.... !!!!!! ???? ,, -- --- "Smartypants, double quotes" and 'single quotes'
1.1.4. Emphasis
This is bold text
❌ This is bold text
❌ This is italic text
This is italic text
❌ ~~Strikethrough~~
1.1.5. Blockquotes
Blockquotes can also be nested...
...by using additional greater-than signs right next to each other...
...or with spaces between arrows.
❌ No proper CSS yet, and they are rendered as multiple blockquotes, not consecutive.
1.1.6. Lists
Unordered
-
Create a list by starting a line with
+
,-
, or*
-
Sub-lists are made by indenting 2 spaces:
-
Marker character change forces new list start:
-
Ac tristique libero volutpat at
-
Facilisis in pretium nisl aliquet
-
Nulla volutpat aliquam velit
-
-
-
Very easy!
Ordered
-
Lorem ipsum dolor sit amet
-
Consectetur adipiscing elit
-
Integer molestie lorem at massa
-
You can use sequential numbers...
-
...or keep all the numbers as
1.
Start numbering with offset:
-
foo
-
bar
1.1.7. Code
Inline code
Indented code
❌
// Some comments line 1 of code line 2 of code line 3 of code
Block code "fences"
Sample text here...
Syntax highlighting
var foo = function (bar) { return bar++; }; console.log(foo(5));
1.1.8. Tables
❌
| Option | Description | | ------ | ----------- | | data | path to data files to supply the data that will be passed into templates. | | engine | engine to be used for processing templates. Handlebars is the default. | | ext | extension to be used for dest files. | Right aligned columns | Option | Description | | ------:| -----------:| | data | path to data files to supply the data that will be passed into templates. | | engine | engine to be used for processing templates. Handlebars is the default. | | ext | extension to be used for dest files. |
1.1.9. Links
❌ Autoconverted link https://github.com/nodeca/pica (enable linkify to see)
1.1.10. Images
Like links, Images also have a footnote style syntax
With a reference later in the document defining the URL location:
1.1.11. Plugins
The killer feature of markdown-it
is very effective support of
syntax plugins.
1.1.11.1. Emojies
❌
Classic markup: :wink: :cry: :laughing: :yum:
Shortcuts (emoticons): :-) :-( 8-) ;)
see how to change output with twemoji.
1.1.11.2. Subscript Superscript
❌
-
19^th^
-
H~2~O
2. Math
Inline math:
E=mc^2
Display math:
E=mc^2
❌ But no support for multiline math yet.
The following is a workaround inspired by lecopivo/scientific-computing-lean, and the syntax is the same as one variant of GFM for math:
f'(x) = \lim_{h → 0} \frac{f(x+h) - f(x)}{h}