Guide pratique : écrire des articles en Markdown pour Odysee
Apprendre simplement à structurer un article avec le langage Markdown.
1. Qu'est-ce que le Markdown ?
Le Markdown est un langage de balisage léger qui permet de mettre en forme un texte à l'aide de caractères très simples.
Son principal avantage est sa simplicité : on peut rédiger un document structuré sans devoir utiliser un éditeur HTML complexe.
Le texte reste également très lisible lorsqu'on regarde directement son code source.
2. Créer un titre
Un titre Markdown commence par un ou plusieurs caractères #.
# Mon premier article
## Première partie
### Un sous-chapitreMon premier article
Première partie
Un sous-chapitre
Plus il y a de #, plus le niveau du titre est profond.
3. Écrire des paragraphes
Il suffit d'écrire normalement son texte. Pour créer un nouveau paragraphe, laissez simplement une ligne vide.
Voici mon premier paragraphe.
Voici mon deuxième paragraphe.
Et voici un troisième paragraphe.4. Mettre du texte en forme
| Markdown | Résultat |
|---|---|
**texte** |
texte |
*texte* |
texte |
***texte*** |
texte |
`code` |
code |
Exemple :
Voici du **texte important**.
Voici du *texte en italique*.
Et voici du ***texte très important***.5. Créer des listes
Liste à puces
- Premier élément
- Deuxième élément
- Troisième élémentCe qui donne :
- Premier élément
- Deuxième élément
- Troisième élément
Liste numérotée
1. Première étape
2. Deuxième étape
3. Troisième étapeLes listes sont particulièrement pratiques pour réaliser des tutoriels.
6. Créer des liens
La syntaxe d'un lien est :
[Texte du lien](https://exemple.com)Par exemple :
[Visiter Odysee](https://odysee.com)Le lecteur pourra alors cliquer sur le texte pour accéder au site.
7. Ajouter une image
Une image utilise une syntaxe proche de celle d'un lien.
Le texte entre crochets correspond à la description de l'image. L'adresse entre parenthèses correspond à l'URL de l'image.
8. Créer une citation
Une citation commence par le caractère >.
> Le savoir n'a de valeur que lorsqu'il est partagé.Exemple de résultat :
Le savoir n'a de valeur que lorsqu'il est partagé.
9. Insérer du code
Le Markdown permet également de présenter proprement du code informatique.
Pour un morceau de code très court, utilisez des accents graves :
`echo "Bonjour";`Pour plusieurs lignes, utilisez trois accents graves.
```php
<?php
echo "Bonjour !";
?>
```On peut généralement indiquer le langage après les trois accents graves :
```php
```html
```javascript
```python10. Comment structurer un véritable article ?
Un bon article ne consiste pas simplement à accumuler du texte. Il est préférable de construire une hiérarchie logique.
Par exemple :
# Titre de l'article
Introduction.
## Première partie
Explication de la première partie.
### Un point particulier
Explication complémentaire.
## Deuxième partie
Nouvelle explication.
### Exemple
Un exemple concret.
## Conclusion
Résumé et conclusion de l'article.11. Exemple complet d'article
Voici maintenant un petit article complet écrit en Markdown.
# Découvrir le journalisme indépendant
Internet permet aujourd'hui à chacun de publier et de partager
des informations.
## Pourquoi publier ses propres articles ?
La publication indépendante permet de présenter des sujets qui
ne trouvent pas toujours leur place dans les médias traditionnels.
### Les avantages
- Liberté éditoriale
- Publication rapide
- Possibilité de travailler en équipe
- Contact direct avec les lecteurs
## Utiliser la vidéo
Une vidéo peut compléter efficacement un article.
[Voir la chaîne sur Odysee](https://odysee.com)
## Conclusion
La publication indépendante permet à chacun de développer
ses propres moyens d'information.
> Informer, vérifier et partager.12. Modèle Markdown prêt à utiliser
Vous pouvez copier le modèle suivant et le modifier pour créer votre propre article.
# TITRE DE MON ARTICLE
Introduction de mon article.
## Première partie
Texte de la première partie.
### Sous-partie
Explication complémentaire.
## Deuxième partie
Voici les informations importantes.
### Liste
- Premier élément
- Deuxième élément
- Troisième élément
## Une image
## Une vidéo ou un lien
[Voir la vidéo](URL-DE-LA-VIDEO)
## Conclusion
Résumé de l'article.
> Une citation ou une phrase importante.13. Quelques conseils avant de publier
- Choisissez un titre clair et précis.
- Utilisez des sous-titres pour séparer les grandes parties.
- Évitez les paragraphes trop longs.
- Ajoutez des liens vers les sources utilisées.
- Utilisez des images lorsque celles-ci apportent réellement quelque chose.
- Relisez les liens avant de publier.
- Vérifiez que les images sont accessibles publiquement.
- Conservez une copie locale de votre article.
14. Markdown ou HTML ?
Le Markdown et le HTML ne sont pas concurrents : le Markdown est une manière beaucoup plus simple d'écrire un document structuré, tandis que le HTML donne un contrôle beaucoup plus précis sur la présentation d'une page Web.
Un article peut donc être rédigé en Markdown puis converti en HTML avant d'être publié sur un blog.
C'est particulièrement pratique pour les personnes qui souhaitent écrire leurs articles dans un simple éditeur de texte tout en obtenant ensuite une page Web correctement structurée.
Conclusion
Le Markdown est relativement simple à apprendre. Une dizaine de syntaxes suffisent déjà pour rédiger des articles propres et structurés.
Pour commencer, retenez surtout :
#pour les titres**gras**pour le texte important*italique*pour l'italique-pour les listes[texte](URL)pour les lienspour les images>pour les citations```pour les blocs de code
Avec ces quelques éléments, il est déjà possible de construire un article complet, lisible et bien organisé.
