Outils pour utilisateurs

Outils du site


tech:markdown

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision
Révision précédente
tech:markdown [2025/04/30 14:48] Jean-Baptistetech:markdown [2026/06/26 16:59] (Version actuelle) Jean-Baptiste
Ligne 1: Ligne 1:
 +<!DOCTYPE markdown>
 +{{tag>Brouillon Markdown}}
 +
 +# Notes Markdown Étendue
 +
 +Voir :
 +  * https://datatracker.ietf.org/doc/html/rfc7763
 +  * https://commonmark.org/
 +  * [GFM](https://help.github.com/articles/github-flavored-markdown/)
 +  * https://tickets.metabrainz.org/secure/attachment/11757/markdown_comparison.pdf
 +  * https://github.com/github/linguist/blob/master/lib/linguist/languages.yml
 +  * https://squidfunk.github.io/mkdocs-material/reference/formatting/
 +
 +Voir aussi
 +  * https://ipfessay.stavros.io/ (IPFS)
 +  * https://google.github.io/styleguide/docguide/style.html
 +  * https://github.com/google/styleguide/blob/gh-pages/docguide/style.md#links
 +
 +Front-Matter :
 +  * https://jekyllrb.com/docs/front-matter/
 +
 +
 +## Lint
 +
 +### markdownlint  (mdl)
 +
 +~~~
 +$ sudo apt-get install markdownlint
 +
 +$ mdl notes_-_nerdctl.txt 
 +notes_-_nerdctl.txt:13: MD012 Multiple consecutive blank lines
 +notes_-_nerdctl.txt:20: MD012 Multiple consecutive blank lines
 +notes_-_nerdctl.txt:24: MD012 Multiple consecutive blank lines
 +notes_-_nerdctl.txt:42: MD012 Multiple consecutive blank lines
 +notes_-_nerdctl.txt:54: MD012 Multiple consecutive blank lines
 +notes_-_nerdctl.txt:55: MD012 Multiple consecutive blank lines
 +notes_-_nerdctl.txt:67: MD012 Multiple consecutive blank lines
 +notes_-_nerdctl.txt:30: MD013 Line length
 +notes_-_nerdctl.txt:50: MD031 Fenced code blocks should be surrounded by blank lines
 +notes_-_nerdctl.txt:7: MD032 Lists should be surrounded by blank lines
 +notes_-_nerdctl.txt:15: MD032 Lists should be surrounded by blank lines
 +notes_-_nerdctl.txt:22: MD032 Lists should be surrounded by blank lines
 +notes_-_nerdctl.txt:15: MD034 Bare URL used
 +notes_-_nerdctl.txt:16: MD034 Bare URL used
 +notes_-_nerdctl.txt:17: MD034 Bare URL used
 +notes_-_nerdctl.txt:18: MD034 Bare URL used
 +notes_-_nerdctl.txt:22: MD034 Bare URL used
 +~~~
 +
 +## Conversion Markdown vers ODT
 +
 +~~~bash
 +pandoc notes.md -f markdown -t odt -o notes.odt
 +~~~
 +
 +### Autres
 +
 +~~~bash
 +pandoc --list-input-formats lists native
 +~~~
 +
 +
 +
 +## Éditeurs Markdown
 +
 +Voir :
 +* hedgedoc
 +
 +### Markdown slide
 +
 +Voir :
 +* https://cryptpad.fr/slide/
 +
 +### Editer un fichier Markdown avec Atom
 +
 +Atom \\
 +Puis [CTRL] + [SHIFT] + [M] \\
 +Ou "Packages - Markdown Preview - Toggle Preview"
 +
 +
 +## Linter
 +
 +Install
 +~~~bash
 +sudo apt-get install ruby-mdl
 +~~~
 +
 +Utilisation
 +~~~bash
 +mdl fichier.md
 +~~~
 +
 +Config - ignorer une règle 
 +~~~
 +mdl ~/code/mkdocs/projet1/docs/start.md 
 +/home/jean/code/mkdocs/projet1/docs/start.md:41: MD013 Line length
 +/home/jean/code/mkdocs/projet1/docs/start.md:171: MD013 Line length
 +
 +mdl -r ~MD013 ~/code/mkdocs/projet1/docs/start.md
 +mdl -r ~MD013,~MD046 ~/code/mkdocs/projet1/docs/start.md
 +~~~
 +
 +## Autres
 +
 +Markdown
 +
 +For security reasons, the Unicode character U+0000 must be replaced with the REPLACEMENT CHARACTER (U+FFFD)
 +
 +~~~bash
 +#sudo add-apt-repository ppa:wereturtle/ppa
 +sudo apt update
 +sudo apt install ghostwriter
 +~~~
 +
 +markdown.pl
 +
  

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki