#markdown

mermaid · GitBook
▻https://mermaidjs.github.io

Generation of diagrams and flowcharts from text in a similar manner as markdown.
Ever wanted to simplify documentation and avoid heavy tools like Visio when explaining your code?
This is why mermaid was born, a simple markdown-like script language for generating charts from text via javascript.

Un générateur (javascript) de diagrammes à partir de sources en markdown.
Basé sur le moteur de rendu de #3djs, utilise la syntaxe de js-sequence-diagram (▻https://bramp.github.io/js-sequence-diagrams)

A tester : l’éditeur en ligne ▻https://mermaidjs.github.io/mermaid-live-editor

Plusieurs éditeurs de code supportant le markdown proposent des plugins pour la prévisualisation (VS Code, Sublime text, VIm...).
Un plugin Gitlab permet d’afficher les schémas intégrés dans les fichiers .md (en particulier le Readme.md) : idéal pour des schémas intégrés à la documentation
(à intégrer dans le plugin markdown de SPIP ?)

#diagramme #javascript #markdown #gitlab #js-sequence-diagram #documentation

Zettlr | Home
▻https://www.zettlr.com

https://zettlr.com/storage/app/media/img/social_media_img.png

Since its inauguration by John Gruber in 2004, #Markdown has made its way to the top of #writing methods. By now, there are numerous different Markdown editors from very simple applications that are designed for pure note keeping towards the most complex editors that not only support Markdown but numerous other languages as well.

Zettlr enters this broad field with a clear aim in mind: To provide the ability to take #notes and write scientific #papers for #researchers in the arts and humanities, a group that has been underrepresented in recent developments.

#écrire

HackMD - Collaborative markdown notes
▻https://hackmd.io

Un éditeur Markdown en ligne avec double fenêtre, barre d’outils... (parmi les nombreux outils équivalents)

#markdown #outil_web #éditeur

JavaScript Markdown Editor - SimpleMDE
▻https://simplemde.com

Un éditeur Markdown en javascript qui propose une vue « quasi » WYSIWYG tout en gardant le code des raccourcis syntaxiques visible. Le concept mi-chèvre mi-choux semble pertinent pour les débutants comme pour les « power-users »
Le dépôt Github : ▻https://github.com/sparksuite/simplemde-markdown-editor

#éditeur #WYSIWYG #javascript #markdown #SPIP

« Ce site est hébergé par Write.as. Certains et certaines l’auront peut-être remarqué. L’occasion pour moi de dire quelques mots de ce service de publication sur le Web atypique au concept plutôt original qui combine minimalisme éditorial, respect de l’anonymat (et même droit aux identités multiples), développement open source, et intégration à la fédiverse. »

▻https://aris.papatheodorou.net/write-as-cest-comme-ca (par @aris )

#WriteFreely #publication #Markdown

Pros and Cons of Using #markdown for Technical Writing
▻https://hackernoon.com/pros-and-cons-of-using-markdown-for-technical-writing-34f277418a8a?sourc

https://cdn-images-1.medium.com/max/770/0*K9l80evHIrtUdKM8.jpg

Many technical writers either currently use or interested in using Markdown to write their technical documentation. It’s a bit like Marmite — some people love it and other people kind of hate it.Markdown generates some controversy, but it still proves incredibly useful in certain contexts. In this post, we’ll discuss exactly what Markdown is, and whether it’s appropriate for your documentation project.Definition of MarkdownJohn Gruber is the original creator of Markdown, and he defines it as:“Markdown is a text-to-HTML conversion tool for web writers. Markdown allows you to write using an easy-to-read, easy-to-write plain text format, then convert it to structurally valid XHTML (or HTML).”Gruber’s definition shows that Markdown intended for anyone producing content on the web — which nowadays (...)

#editor #technical-documentation #technical-writing #markdown-tech-writing

markdown/README.md at master · Cerdic/markdown · GitHub
▻https://github.com/Cerdic/markdown/blob/master/README.md

Ce plugin permet d’utiliser la syntaxe MarkDown dans un article SPIP.
Un formulaire de configuration permet de choisir le fonctionnement du plugin :
- Appliquer la syntaxe SPIP par défaut et la syntaxe MarkDown dans les blocs <md>..</md>
- Appliquer la syntaxe MarkDown par défaut et la syntaxe SPIP dans les blocs <spip>..</spip>

#SPIP #markdown #text_wheel #syntaxe

Mark Text
▻https://marktext.github.io/website

https://raw.githubusercontent.com/marktext/marktext/master/doc/marktext.gif

Mark Text is a Markdown editor for Mac, Windows, and Linux. It is a concise text editor, dedicated to improving your editing efficiency.

Mark Text supports both the CommonMark Spec and the GitHub Flavored Markdown Spec. Because Mark Text is a realtime preview editor text styles and formatting update automatically as you type.

#markdown #editeur_de_texte #wysiwyg #electron #open_source

Mermaid: Markdown-like generation of diagrams and flowcharts from t...
▻https://diasp.eu/p/7050566

Mermaid: Markdown-like generation of diagrams and flowcharts from text

HN link: ▻https://news.ycombinator.com/item?id=16889181 Posted by tomcam (karma: 3764) Post stats: Points: 106 - Comments: 18 - 2018-04-20T23:43:04Z

#HackerNews #and #diagrams #flowcharts #from #generation #markdown-like #mermaid #text HackerNewsBot debug: Calculated post rank: 76 - Loop: 64 - Rank min: 60 - Author rank: 26

Joplin - an open source note taking and to-do application with synchronisation capabilities
▻https://joplin.cozic.net

https://joplin.cozic.net/images/AllClients.jpg

Joplin is a free, open source note taking and to-do application, which can handle a large number of notes organised into notebooks. The notes are searchable, can be copied, tagged and modified either from the applications directly or from your own text editor. The notes are in #Markdown format.

#notes #écrire #open_source #outils

Je ne retrouve plus le fil sur les #éditeurs de #notes si possible en #markdown.
En voilà un autre dont personne n’a l’air d’avoir parlé ici, #encrypté, bien sûr : #Skrifa
▻https://skrifa.xyz

https://skrifa.xyz/img/editor.png

The vanilla Skrifa, is all about keeping your privacy safe. With encryption to all of your notes by default using PGP, secure sharing of your notes and other PGP functionalities, this is the best note taking app for you and your privacy.

Dans la lignée de #Standard_notes

JAMstack | JavaScript, APIs, and Markup
▻https://jamstack.org

JAMstack: noun \’jam-stak’\
Modern web development architecture based on client-side JavaScript, reusable APIs, and prebuilt Markup.
When we talk about “The Stack,” we no longer talk about operating systems, specific web servers, backend programming languages, or databases.

The JAMstack is not about specific technologies. It’s a new way of building websites and apps that delivers better performance, higher security, lower cost of scaling, and a better developer experience.

#web #cms #html #markdown #git #jamstack

Using A Static Site Generator At Scale: Lessons Learned – Smashing Magazine
▻https://www.smashingmagazine.com/2016/08/using-a-static-site-generator-at-scale-lessons-learned

https://www.smashingmagazine.com/wp-content/uploads/2016/08/new_github-screenshot-opt.png

Static site generators are pretty en vogue nowadays. It is as if developers around the world are suddenly realizing that, for most websites, a simple build process is easy enough to render the last 20 years of content management systems useless. All right, that’s a bit over the top. But for the average website without many moving parts, it’s pretty close!

#web #cms #html #markdown #git #jamstack

What is a Headless CMS? | CSS-Tricks
▻https://css-tricks.com/what-is-a-headless-cms

https://css-tricks.com/wp-content/uploads/2016/03/headless.svg

Have you heard this term going around? It’s quite in vogue. It’s very related to The Big Conversation™ on the web the last many years. How are we going to handle bringing Our Stuff™ all these different devices/screens/inputs.

Responsive design says “let’s let our design and media accommodate as much variation in screens as possible.”

Progressive enhancement says “let’s make the functionality of this site work no matter what.”

Designing for accessibility says “let’s ensure everyone can use this regardless of their capabilities as a person.”

A headless CMS says “let’s not tie our data to any one way of doing things.”

#Web #cms #html #markdown #git

Documentation generator for shell scripts (bash, sh, zsh) ▻https://github.com/reconquest/shdoc

#bash #scripting #documentation #generator #markdown

A command-line based markdown presentation tool.
►https://github.com/visit1985/mdp

#markdown #commandline

mdp, A command-line based #Markdown presentation tool.

►https://github.com/visit1985/mdp

https://cloud.githubusercontent.com/assets/2237222/5810237/797c494c-a043-11e4-9dbd-959cab4055fa.gif

#présentation #slides #diapositives

Vega / Vega-Lite

Introducting Vega Lite
▻https://medium.com/hci-design-at-uw/introducing-vega-lite-438f9215f09e
▻http://idl.cs.washington.edu/files/2017-VegaLite-InfoVis.pdf

Visdown (taper du vega en #markdown + #yaml)
▻http://visdown.amitkaps.com

The Lyra Visualization Design Environment (VDE) ►http://idl.cs.washington.edu/projects/lyra

What I Learned Recreating One Chart Using 24 Tools - Features - Source : An OpenNews project
▻https://source.opennews.org/en-US/articles/what-i-learned-recreating-one-chart-using-24-tools

http://assets.opennews.org.s3.amazonaws.com/img/24tools/mental_map.png

Vega Editor
▻http://vega.github.io/vega-editor/index.html?mode=vega&spec=force_drag

Exemple de specs
▻https://github.com/vega/vega/blob/master/spec/airports.vg.json

Roll your own charting system
▻https://blog.interactivethings.com/roll-your-own-charting-system-69f5753efc1c

Users mailing list
▻https://groups.google.com/forum/#!topic/vega-js/9EDKEFEZ8Zo

Interaction scenarios
▻https://github.com/vega/vega/wiki/Interaction-Scenarios

un block test
▻http://bl.ocks.org/espinielli/87047968c67c02dbcb8d

vega-lite et #R
▻http://rud.is/b/2016/02/27/create-vega-lite-specs-widgets-with-the-vegalite-package

–---

gganimate : animation avec ggplot2
▻https://www.youtube.com/watch?v=9Y7Y1s4-VdA

#d3.js #visualisation #graphs

#Ghostwriter, an #Open-Source #Markdown Editor - OMG! Ubuntu!
▻http://www.omgubuntu.co.uk/2016/12/ghostwriter-stylish-open-source-markdown-editor

http://www.omgubuntu.co.uk/wp-content/uploads/2016/12/screenshot1.jpg

Ghostwriter is a free, open-source markdown editor for Linux and Windows.

Billed as being ‘distraction free’, the Qt based app doesn’t scrimp on features at the expense of looking minimal and stylish.

Pense bête #markdown · jekyll-fr/jekyll-fr.github.io Wiki
▻https://github.com/jekyll-fr/jekyll-fr.github.io/wiki/Pense-b%C3%AAte-Markdown
#cheatsheet

bookdown: Authoring Books with #R Markdown
▻https://bookdown.org/yihui/bookdown

The bookdown package was built on top of R Markdown (▻http://rmarkdown.rstudio.com), and inherited the simplicity of the #Markdown syntax (you can learn the basics in five minutes; see Section 2.1), as well as the possibility of multiple types of output formats (PDF/HTML/Word/…). It also added features like multi-page HTML output, numbering and cross-referencing figures/tables/sections/equations, inserting parts/appendices, and imported the GitBook style (►https://www.gitbook.com) to create elegant and appealing HTML book pages. This book itself is an example of how you can produce a book from a series of R Markdown documents, and both the printed version and the online version can look professional.

Stylish #Markdown Editor ’Typora’ Is Now Available for Ubuntu - OMG ! Ubuntu !
▻http://www.omgubuntu.co.uk/2016/09/typora-stylish-minimal-markdown-editor-now-available-ubuntu

http://www.omgubuntu.co.uk/wp-content/uploads/2016/09/markdown-toggle.jpg

Typora is both a reader and a writer at the same time. There’s no preview window to toggle on, no on-screen toolbar of formatting buttons, and you won’t see any markdown elements as you write.

Atom
▻https://atom.io

Un éditeur de texte évolué, open-source, cross-platforms, avec un ensemble de plugins (packages) bien fournis et un système de snippets qui semble pratique...
La doc officielle : ▻http://flight-manual.atom.io
(dommage : pas de possibilité de traduction du core ou des packages : cf ▻https://github.com/atom/atom/issues/3103)

Package pour le Markdown : ▻https://atom.io/packages/markdown-writer

NB pour contourner l’installation sous Windows dans le AppData de l’utilisateur sans donner le choix (ce qui est bien naze pour un open-source !) :
– une fois l’installation terminée, déplacer le dossier c :\users\nom_utilisateur\AppData\atom vers l’endroit voulu
– modifier les chemins des raccourcis (menu Démarrer, bureau...)
– ajouter le chemin du dossier atom dans le PATH

#atom #editeur #markdown #open_source #logiciel

Traitement de texte multicanal - Frank Taillandier
▻http://frank.taillandier.me/2016/08/28/traitement-de-texte-multicanal

https://ia.net/content/4-know-how/20160610-multichannel-text-processing/full-multichannel-text-processing.png

Comme je l’expliquais dans la mouvance statique, il est important de bien choisir le format de fichier dans lesquels nous allons stocker nos écrits. C’est souvent la solution la plus simple qui est aussi la plus efficace : du texte brut mise en forme à l’aide d’une syntaxe elle aussi en #texte brut. #Markdown est de ce fait un format de fichier de plus en plus populaire car il assure une pérennité et une compatibilité à nos documents, tout en préservant une mise en forme au format texte. Markdown est le format par défaut des contenus dans la plupart des générateurs de site statique et il devrait devenir aussi le format par défaut dans lequel vous rédigez vos notes, vos rapports, vos articles de blog ou vos livres.

doctoc: generate table of content for markdown files
▻https://github.com/thlorenz/doctoc

Generates table of contents for markdown files inside local git repository. Links are compatible with anchors generated by github or other sites.

#Markdown_toc