Guide

This is a guide for using Nota, and a basic markdown (GFM) guide.

Table of contents

Markdown

Headers

H1: # Header level-1
H2: ## Header level-2
H3: ### Header level-3
H4: #### Header level-4
H5: ##### Header level-5
H6: ###### Header level-6

Or alternatively, for H1 and H2, an underline-ish style:

Alt H1
======

Alt H2
------

Emphasis

Emphasis, aka italics, with *asterisks* or _underscores_.

Strong emphasis, aka bold, with **asterisks** or __underscores__.

Combined emphasis with **asterisks and _underscores_**.

Strikethrough uses two tildes. ~~Scratch this.~~

Emphasis, aka italics, with asterisks or underscores.

Strong emphasis, aka bold, with asterisks or underscores.

Combined emphasis with asterisks and underscores.

Strikethrough uses two tildes. Scratch this.

Lists

Unordered lists

Unordered lists can use *, + and -.

* List item one
- List item two
    * Sub list item
+ List item three
Ordered lists

Ordered lists can use any number, order doesn't matter.

1. List item one
2. list item two
    5. Sub list item
0. list item three
  1. List item one
  2. list item two
    1. Sub list item
  3. list item three
Mixed lists
1. List item one
2. list item two
    * Sub list item
0. list item three
  1. List item one
  2. list item two
    • Sub list item
  3. list item three

There are two ways to create links.

Inline
[Inline-style link][ref-1]

[Inline-style link with title][ref-2]

Inline-style link

Inline-style link with title

Reference
[Reference-style link using number][1]

[Reference-style link using text][reference link]

[1]: http://example.com/number
[reference link]: http://example.com/text

Reference-style link using number

Reference-style link using text

Images

Like links, there are two ways to insert images: inline and reference.

Inline (img)
![alt text][ref-5]

alt text

Reference (img)
![alt text][image]

[image]: http://www.placehold.it/302x150.gif "Image 2 title"

alt text

Code and Syntax Highlighting

Code blocks are part of the original Markdown spec, but syntax highlighting isn't. However, many renderers support syntax highlighting. Nota supports syntax highlighting for most of the popular languages.

Inline `code` has `back-ticks around` it.

Inline code has back-ticks around it.

Blocks of code are either fenced by lines with three back-ticks ```, or are indented with four spaces. It's recommended to only use the fenced code blocks — they're easier and only they support syntax highlighting.

```javascript
var s = "JavaScript syntax highlighting";
alert(s);
```

```python
s = "Python syntax highlighting"
print s
```

```
No language indicated, so no syntax highlighting.
```
<div class="xml">Syntax highlighting</div>
.css {
    syntax: 'highlighting';
}
No language indicated, so no syntax highlighting.

Tables

Tables aren't part of the core Markdown spec, but they are part of Github Flavored Markdown (GFM). They are an easy way of adding tables to your email — a task that would otherwise require copy-pasting from another application.

Colons can be used to align columns.

| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is      | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |

The outer pipes (|) are optional, and you don't need to make the raw Markdown line up prettily. You can also use inline Markdown.

Markdown | Less | Pretty
--- | --- | ---
*Still* | `renders` | **nicely**
1 | 2 | 3

Colons can be used to align columns.

Tables Are Cool
col 3 is right-aligned $1600
col 2 is centered $12
zebra stripes are neat $1

The outer pipes (|) are optional, and you don't need to make the raw Markdown line up prettily. You can also use inline Markdown.

Markdown Less Pretty
Still renders nicely
1 2 3

Blockquotes

> Blockquotes are very handy in email to emulate reply text.
> This line is part of the same quote.

Quote break.

> This is a very long line that will still be quoted properly when it wraps. Oh boy let's keep writing to make sure this is long enough to actually wrap for everyone. Oh, you can *put* **Markdown** into a blockquote.

Blockquotes are very handy in email to emulate reply text.
This line is part of the same quote.

Quote break.

This is a very long line that will still be quoted properly when it wraps. Oh boy let's keep writing to make sure this is long enough to actually wrap for everyone. Oh, you can put Markdown into a blockquote.

Inline HTML

You can also use raw HTML in your Markdown, and it'll mostly work pretty well.

<dl><dt>Definition list</dt><dd>Is something people use sometimes.</dd><dt>Markdown in HTML</dt><dd>Does *also* work **very** well.</dd></dl>
Definition list
Is something people use sometimes.
Markdown in HTML
Does also work very well.

Note: Inline HTML should all be on one line (GFM will force a <br> tag on every newline).

Horizontal Rules

Three or more...

---

Hyphens

***

Asterisks

___

Underscores

Three or more...


Hyphens


Asterisks


Underscores

Youtube videos

They can't be added directly but you can add an image with a link to the video like this:

<a href="http://www.youtube.com/watch?feature=player_embedded&v=YOUTUBE_VIDEO_ID_HERE
" target="_blank"><img src="http://img.youtube.com/vi/YOUTUBE_VIDEO_ID_HERE/0.jpg"
alt="IMAGE ALT TEXT HERE" width="240" height="180" border="10" /></a>

Or, in pure Markdown, but losing the image sizing and border:

[![IMAGE ALT TEXT HERE](http://img.youtube.com/vi/YOUTUBE_VIDEO_ID_HERE/0.jpg)][ref-7]

Using the editor

Besides just editing and previewing markdown, Nota has some very handy features to make editing a lot more efficient and easy. All these features are accessible via the menus, and via shortcuts (wich you can find in the dropdown menus and by hovering over a button). Most features for editing you can find in the Editing Toolbar.

Lists

You can begin a list by typing 1. / *, or by pressing Ctrl + L / Ctrl + Shift + L. If you press enter the list will automtically continue. If you want to turn some lines of text into a list you can select it and press Ctrl + L to turn it into an unordered list, or Ctrl + Shift + L to turn in into an ordered list. This will also work to change list types of existing lists. These features can also be accessed via the Editing Toolbar.

Editing toolbar

You can acces the Editing Toolbar via the dropdown menus or by pressing Ctrl + Shift + T. The Editing Toolbar's position can be changed by dragging it around, to bring it back to it's default position you right click the close button.

Hover over the buttons of the Editing Toolbar to see what they do and what shortcuts they are bound to. A lot of buttons do something different when you right click them, this is also shown on hovering over them.

Blockquotes

You can turn any selected text or line into a blockquote by pressing Ctrl + Shift + B. Press multiple times to further nest blockquotes.

If you've just copied a link you can paste it directly as markdown link using Ctrl + Shift + W (or right-clicking the paste button on the Editing Toolbar). If you've selected some text this text will be turned into a link.

Convert all inline linked content to references

This feature scans the entire document for inline linked content (images and links) and replaces them with reference links, references collected at the end of the document.

You can do this via de Edit menu or by pressing Ctrl + R.

Table of contents

If you want to insert a table of contents based on the headers used in your document you can do this by pressing Ctrl + Shift + O. This will be list with links to the corresponding headers and will be indented based on the header level. Like this:

* [Level-1 header][ref-8]
    * [Level-2 header][ref-9]
        * [Level-3 header][ref-10]
        * [Level-4 header][ref-11]
            * [Level-5 header][ref-12]
            * [Level-6 header][ref-13]
Automatic table of contents

To insert a automatically updating table of contents you can type {Table of contents} or {TOC}. This TOC will automatically update if you add or remove any headers. Automatic TOC will only include headers using #. If you want to exclude a header from the automatic TOC you can remove the space between the # and the header text. Like this: #header.

Note: this is not part of the official Markdown spec and will only work in this editor. If you're going to copy over your document to another editor I suggest you replace {TOC} with a non-automatic TOC.

Exporting HTML

To export your document to HTML you can press Ctrl + E or click the quick-export button on the top right. This will export your HTML document without any styling. If you want to include a CSS theme you can either use the Ctrl + Shift + E shortcut or right click the quick-export button.

Copying HTML

To copy your document as HTML you can press Ctrl + Shift + C or click the quick-copy button on the top right. This will copy your HTML document without any styling. If you want to include a CSS theme you can either use the Ctrl + Shift + K shortcut or right click the quick-copy button.

Document title

The first line of your document will be the title of any HTML document you export. It will also be the suggested name when saving.

If you want to give your document a title but don't want that title to be visible inside your document you can wrap it in {hidden} or {h} tags.

Hidden content

If you have any content you don't want to be visible you can wrap it inside {hidden} or {h} tags.

Note: This is a Nota only feature!

Snippets

Snippet is a programming term for a small region of re-usable source code, or text. In [app name] you can insert snippets by pressing and holding Ctrl + Tab and clicking a snippet. You can save snippets of text/code as .snippet in the C:\Program files\[app name]\snippets folder.

There are no restrictions in using snippets. You can use snippets in any way you want.

Themes

You can change the look of the live preview using CSS themes. If for example you are writing for a particular website, you (or someone with CSS knowledge) can copy that site's CSS and make it into a theme, so your preview will look exactely the same as when you publish your article on this website. Or you just want to change the look of it.

To select a theme you can either use the Ctrl + T shortcut or click Set Preview Theme in the options menu.

Making a theme

When your editing your custom theme it's recommended to only style elements like p or a etc. Don't apply any styling to div elements for example. This will mess up your theme.

Note: you can apply styling to the .wrapper element, which is wrapped around all content.

To enable syntax highlighting in your theme you can copy over css from some pre-made syntax highlighting stylesheets in the /themes/hl/ folder.

To select your theme in the editor you must save it in the C:\[path to app]\themes folder.

Printing

You can print using the Ctrl + P shortcut or via the File menu. If you have Adobe Acrobat installed you can also print to PDF.

Page breaks

To insert a page break you can type {Page break} or {PB}. This will force the printer to start a new page. It will be visible as a dashed line only in the preview window.

Searching

Start searching: Ctrl + F
Find next: Ctrl + G
Find previous: Ctrl + Shift + G
Replace: Ctrl + Shift + F
Replace all: Ctrl + Shift + R

To remove a search query use Ctrl + F + Enter.

Other tips