Markdown Cheatsheet
Cette feuille de triche Markdown est conçue comme une référence rapide et une vitrine de la syntaxe de Markdown dans QOwnNotes.
Headings
Utilisez des titres pour structurer vos textes.
# H1
## H2
### H3
#### H4
##### H5
###### H6
Conseil
Le panneau de navigation montre la structure de vos en-têtes.
Alternativement, pour H1 et H2, un style souligné:
Alt-H1
======
Alt-H2
------
Conseil
Par défaut, QOwnNotes crée le nom de fichier d'une note à partir de l'en-tête 1 (h1).
Accentuation
Emphasis, aka italics, with *asterisks* or _underscores_.
Strong emphasis, aka bold, with **asterisks** or __underscores__.
Combined emphasis with **asterisks and _underscores_**.
Conseil
Vous pouvez utiliser le raccourci Ctrl + B pour mettre le texte en gras et Ctrl + I pour le mettre en italique.
Souligné
There also is an optional setting to enable underline rendering in the Preview settings.
_souligner_
Conseil
Vous pouvez utiliser le raccourci Ctrl + U pour souligner un texte.
Rayer
~~biffer~~
Conseil
Vous pouvez utiliser le raccourci Alt + Maj + S pour biffer un texte.
Listes
Il existe de nombreuses façons de créer des listes.
1. Premier élément de liste commandé
2. Another item
- Unordered sub-list.
1. Actual numbers don't matter, just that it's a number
1. And another item.
* Unordered list can use asterisks
- Or minuses
+ Or pluses
Conseil
Si vous appuyez sur Entrée à la fin d'une liste, un nouvel élément de liste sera créé.
Liens
Two of the simpler uses for links are pointing to webpages or other notes. There are multiple ways each of these links can look.
External links
[I'm an inline-style link](https://www.google.com)
[I'm an inline-style link with title](https://www.google.com "Google's Homepage")
[You can use numbers for reference-style link definitions][1]
Plain URLs and URLs in angle brackets will automatically get turned into links in the preview.
http://www.example.com ou <http://www.example.com>
[1]: https://www.qownnotes.org
Internal links
You can link to other notes or attachments like this:
[I link to the Journal.md note](Journal.md)
<Journal.md> works similarly.
Conseil
Vous pouvez utiliser le raccourci Ctrl + L pour créer des liens vers des pages Web ou d’autres notes.
L'utilisation de Ctrl + Maj + X fera apparaître une boîte de dialogue qui vous aidera à insérer des pièces jointes dans votre note.
Vous pouvez appuyer sur Ctrl + Espace pendant que le curseur se trouve sur un lien dans l'édition de note pour suivre le lien.
Avertissement
Info Internal links with a title are not supported:
[I link to the Journal.md note](Journal.md "Title not supported")
Bookmarks
Les signets utilisés par l'extension de navigateur QOwnNotes Web Companion utilisent des liens dans des listes.
- [Webpage name](https://www.example.com) #tag1 #tag2 some description and tags
Images
Les images peuvent être intégrées dans QOwnNotes. Ils seront affichés dans l'aperçu.
Conseil
Vous pouvez utiliser le raccourci Ctrl + Maj + I pour insérer une image dans une note. L'image peut également être dans le presse-papiers, la boîte de dialogue la détectera et affichera un aperçu.
Vous pouvez également coller directement une image du presse-papiers dans votre note avec Ctrl + Maj + V.
Avertissement
Info Image links with a title are not supported:
Code en ligne et blocs de code
Inline `code` has `backticks around` it.
Conseil
Vous pouvez utiliser le raccourci Ctrl + Maj + C sur texte en ligne sélectionné ou juste à l'intérieur du texte pour créer un bloc de code en ligne.
Blocks of code are either fenced by lines with three backticks, or are indented with four spaces.
4-Spaces fence
Ajoutez quatre espaces devant votre code pour le marquer comme bloc de code.
s = "Code with space indent"
print s
Backtick fence
Vous pouvez également utiliser trois backticks pour créer un bloc de code.
```
Code goes here
Code goes here
```
Conseil
You can use the shortcut Ctrl + Shift + C on multiple selected lines of text or in an empty line to create a code block.
Backtick fence with code highlighting
There also is some syntax highlighting with code blocks in QOwnNotes.
```bash
# I am a comment
cd Notes
Currently, supported languages (and code block identifiers) are:
- BASh scripting, `bash`
- C, `c`
- C++, `cpp`
- C++, `cxx`
- C++, `c++`
- C#, `c#`
- CMake, `cmake`
- C#, `csharp`
- CSS, `css`
- Go, `go`
- HTML, `html`
- INI, `ini`
- Java, `java`
- JavaScript, `javascript`
- JavaScript, `js`
- JSON, `json`
- Makefile, `make`
- PHP, `php`
- Python, `py`
- Python, `python`
- QML, `qml`
- Rust, `rust`
- Shell scripting, `sh`
- SQL, `sql`
- TypeScript, `ts`
- TypeScript, `typescript`
- V, `v`
- Vex, `vex`
- XML, `xml`
- YAML, `yml`
- YAML, `yaml`
## Tables
Tables aren't part of the core Markdown spec, but the QOwnNotes preview supports them.
```markdown
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 |
There must be at least 3 dashes separating each header cell.
You can also use inline Markdown.
| Markdown | Less | Pretty |
| -------- | --------- | ---------- |
| _Still_ | `renders` | **nicely** |
| 1 | 2 | 3 |
Conseil
Appuyez sur Alt + Maj + T pour faire apparaître une boîte de dialogue qui vous aidera à créer des tableaux. Vous pouvez même importer des fichiers CSV dans cette boîte de dialogue.
Utilisez Ctrl + Espace dans un tableau de démarquage pour le formater automatiquement.
Blocs de citation
> 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.
Conseil
You can tell QOwnNotes to fully highlight blockquotes or just the blockquote character in the Editor settings
Vous pouvez utiliser le raccourci Ctrl + Maj + B pour marquer le texte comme blockquote.
Règle horizontale
Il existe trois façons d'obtenir une règle horizontale: traits d'union, astérisques ou traits de soulignement.
Three or more...
Hyphens
---
Asterisks
***
Underscores
___
Sauts de ligne
- Vous pouvez construire un paragraphe comme un enchaînement de plusieurs lignes pour en faciliter l'édition, il sera tout de même affiché comme un seul paragraphe.
- Dans un paragraphe, vous pouvez forcer un retour à la ligne en insérant deux espaces à la fin d'une ligne.
- Vous pouvez définir un paragraphe distinct en le délimitant avec des sauts de ligne.
Conseil
Vous pouvez insérer deux espaces et un retour à la ligne avec ⇧ Shift + Entrée.
Here's a line for us to start with.
This line is separated from the one above by two newlines, so it will be a _separate paragraph_.
This line also begins a separate paragraph, but...
This line is only separated by two trailing spaces and a single newline, so it's a separate line in the _same paragraph_.
Conseil
Les espaces de fin sont mis en évidence par défaut dans l'éditeur.
Commentaires
Les commentaires ne sont pas affichés dans l'aperçu.
[comment]: # "This comment will not appear in the preview"
<!-- HTML comments are also hidden -->
Conseil
Un bloc de commentaire HTML en tête d'une note sera également ignoré dans la génération automatique du nom de fichier de la note.
Listes de cases à cocher
Vous pouvez créer des listes de tâches simples avec des listes de cases à cocher.
- [x] done
- [ ] todo
Conseil
Vous pouvez cocher / décocher les cases à cocher dans l'aperçu.
Frontmatter
Dans QOwnNotes, vous pouvez utiliser un « frontmatter » (par exemple YAML) pour ajouter des méta-informations supplémentaires. Il ne sera pas affiché dans l'aperçu et ne perturbera pas la génération automatique de nom de fichier de note.
---
title: Some name
description: Some description
---
# Note headline starts here
Some text
Le nom de fichier de cet exemple de note serait L'en-tête de la note commence ici.md.