MarkdownDown
▻https://markdowndown.vercel.app
Convert any webpage to a clean markdown
w/ images downloaded.
MarkdownDown
▻https://markdowndown.vercel.app
Convert any webpage to a clean markdown
w/ images downloaded.
Tables in Markdown | Codeberg Documentation
▻https://docs.codeberg.org/markdown/tables-in-markdown
documentation de la syntaxe MarkDown pour les tables/tableaux
NB :
– à priori fourni en tant qu’extension par la version "GitHub Flavored" MarkDown (GFM) : cf la définition/spécification sur ▻https://github.github.com/gfm/#tables-extension-
– ne semble pas supporté par la version "Commonmark" MarkDown (cf son absence dans la définition sur ▻https://spec.commonmark.org )
– ne propose aucune option de fusion de cellules (contrairement à SPIP) : seul MultiMarkdown semble le proposer : cf ►https://github.com/fletcher/MultiMarkdown/wiki/MultiMarkdown-Syntax-Guide
#markdown #MD #GFM #GitHub_Flavored #Commonmark #syntaxe #tableau #table
Markdown & vous – Publication de livres en toute simplicité
▻https://e-publish.uliege.be/md
Avec le numérique et ce qu’il peut nous offrir mais aussi ce qu’il a tendance à nous imposer, il devient nécessaire de s’arrêter un moment. Ce manuel est consacrés à l’écriture académique avec Markdown et Pandoc.
À la fois plaidoyer pour l’écriture numérique ouverte et introduction à Markdown et à Pandoc, il propose une réflexion sur nos outils et méthodes d’écriture académique. Il n’en est pas pour autant limité aux seuls débutants. L’idée est de revenir aux fondamentaux et donc de ne pas essayer de reproduire coûte que coûte tout ce qui est possible avec un traitement de texte classique (dont on peut se passer).
L’objectif de ce manuel est d’expliquer pourquoi il est possible de changer ses habitudes pour rédiger, structurer ses idées, produire des documents de qualité et de montrer ce qui est possible avec Markdown au travers de quelques méthodes.
#PHP Annotated – June 2023 | The PhpStorm Blog
▻https://blog.jetbrains.com/phpstorm/2023/06/php-annotated-june-2023
▻https://developer.wordpress.com/2023/05/23/wp-now-launch-a-local-environment-in-seconds
wp-now – A #local_dev_environment from the WordPress engineering team. This tool leverages WebAssembly to operate PHP on top of Node.js’ webserver. It’s faster than Docker-based environments and can be used with any PHP apps, although, you’ll have to figure out a way to run your DB.
▻https://github.com/jolicode/castor
jolicode/castor – A #task_runner and #command_launcher designed with a focus on developer experience, built using PHP.
▻https://github.com/ProjektGopher/whisky
ProjektGopher/whisky – Simple and framework-agnostic #CLI tool for managing and enforcing a PHP project’s #git #hooks across a team.
librarianphp/librarian – A #static_site_generator and #markdown indexer inspired by Hugo and DEV, written in PHP.
▻https://localheinz.com/articles/2023/05/10/avoiding-empty-in-php
Avoiding empty() in PHP by Andreas Möller.
Tiens je le connaissais pas celui là, encore un éditeur de notes, basé sur Markdown, multi-plateformes, et basé uniquement sur le système de fichier (pas de stockage propriétaire quoi), et donc synchronisable avec n’importe quel outil existant ensuite (syncthing etc). Et aussi conçu modulairement avec une base et des plugins possibles pour augmenter (660 actuellement).
Obsidian
▻https://obsidian.md
Graph view
The graph is your knowledge at a glance. Explore, observe, and stay motivated. With group, filter, and display options, see things your way.
Local graph shows connections around you. Get inspired while writing.
Backlinks
Converge your thoughts.
Broaden your view to see this note in other contexts. Link relevant pages with one click.
Outgoing links
Diverge your thoughts.
See all existing and potential links from this note. Turn mentions into links with one click.
poulala Zettelkasten, Anki, faut passer 12 ans à apprendre des choses pour apprendre des choses
Un nouveau venu dans la famille des couteaux suisses : ▻https://anytype.io
We started Anytype to empower sovereignty and cooperation at scale.
More precisely: In today’s world, software has propelled us to unprecedented levels of innovation, cross-border communication and value capture.
At the same time, we noticed that participation in today’s digital reality often required sacrificing our independence, privacy, data, or information about ourselves, for purposes we weren’t comfortable with. Ultimately, we decided to put an end to our own feelings of vulnerability and disempowerment, by forging a new path towards scalable cooperation that respects user sovereignty.
By developing a tool where anyone can create and share without an intermediary, our hope is to demonstrate a system wherein cooperation can flourish without third-party intervention, oversight, and control.
By developing an ecosystem where anyone can be both a participant or a builder, our hope is to democratize who gets access to the web, and who gets their voice heard.
We’re still in the early stages of our journey, but ultimately we’re building the Internet that we want to use, one step at a time.
Thoughts On #Markdown — Smashing Magazine
▻https://www.smashingmagazine.com/2022/02/thoughts-on-markdown
If you’re going for markdown, at least consider the following trade-offs:
– Markdown is not great for the developer experience in modern stacks
– Markdown is not great for editorial experience
– Markdown is not great in block content age, and shouldn’t be forced into it. Block content needs to
Article intéressant sur l’histoire de MD et de ses dérivés, leurs usage, etc. (avec une mention à propos des #block_content).
Today, I will argue that Markdown’s primary users are developers and people who are interested in code. It’s not a coincidence that Slack made the WYSIWYG the default input mode once their software was used by more people outside of technical departments. And the fact that this was a controversial decision, so much that they had to bring it back as an option, shows how deep the love for markdown is in the developer community. There wasn’t much celebration of Slack trying to make it easier and more accessible for everyone. And this is the crux of the matter.
[…]
The portability of content has much more to do with how you structure that content in the first place. Take WordPress, it’s fully open-source, you can host your own DB. It even has a standardized export format in XML. But anyone who has tried to move out of a mature WordPress install knows how little this helps if you’re trying to get away from WordPress.
[…]
Ça on le dit depuis le début :
Embedding specific presentation concerns in your content has increasingly become a liability and something that will get in the way of adapting, iterating, and moving quickly with your content. It locks it down in ways that are much more subtle than having content in a database. You risk ending up in the same place as moving out of a mature WordPress install with plugins. It is cumbersome to unmix structure and presentation.
On retrouve ►https://github.com/portabletext/portabletext que j’avais déjà évoqué autour de SPIP il y a 3 ans :
▻https://git.spip.net/spip/porte_plume/issues/3720#issuecomment-21130
#web #développement #intégration #édition #contenu #rédaction #portabilité #interopérabilité #structured_data
Discover the best Apps for GNOME – Apps for GNOME
▻https://apps.gnome.org/en
Discover the best applications in the GNOME ecosystem and learn how to get involved.
Apps featured in this curated overview are all built with the GNOME philosophy in mind. They are easy to understand and simple to use, feature a consistent and polished design and provide a noticeable attention to details.
Wow, un site de présentation des applications “à la gnome” dans lequel je découvre quelques trucs que je ne connaissais pas :
Curtail is an useful #image #compressor, supporting PNG, JPEG and WEBP file types.
▻https://apps.gnome.org/app/com.github.huluti.Curtail
Apostrophe is a GTK based distraction free #Markdown #editor, originally created by Wolf Vollprecht and maintained by Manuel Genovés. It uses pandoc as backend for markdown parsing and offers a very clean and sleek user interface.
▻https://apps.gnome.org/app/org.gnome.gitlab.somas.Apostrophe
#Webfont Kit #Generator is a simple utility that allows you to generate woff, woff2 and the necessary CSS boilerplate from non-web font formats (otf and ttf).
▻https://apps.gnome.org/app/com.rafaelmardojai.WebfontKitGenerator
#Contrast checks whether the contrast between two colors meet the #WCAG requirements.
▻https://apps.gnome.org/app/org.gnome.design.Contrast
Et plein d’autres à découvrir !
Trop bien pour Apostrophe, j’ai utilisé pendant des années un éditeur MD du même auteur mais qu’il n’avait pas fait du tout en GTK, donc là trop bien c’est plus fluide et rapide
Par contre tout est en flatpak, et du coup faut l’installer en plus pour la logithèque (ce qui n’est pas le cas par défaut sur Ubuntu). Et ça prend cent fois plus de place.
How I work, Part V : #Zettlr and Academic #Markdown | Hendrik Erz
▻https://www.hendrik-erz.de/post/how-i-work-part-v-zettlr-and-academic-markdown.html
During the late summer of 2017, I played around a little bit with a framework I recently discovered, called Electron. Its idea is simple: Write a web-application, and load that into some binary so that it looks as if you had a native application on your computer. After fiddling around with it for a few days, I figured that I could both load in Pandoc and use it to have a graphical user interface for using it1, and also that I could spin up a code editor that lets me edit Markdown files. I realised that, instead of having to live with a subpar academic writing experience, I could forge my own. And so I began focusing on improving Zettlr more and more so that – in the end – I would have a tool for my academic workflow that “just works.”
What I didn’t realise back then is something John MacFarlane from the Pandoc project recently explained: An Open Source project of yours is first like your little baby: It’s something you made and of which you are proud. But then, a few months into development, it becomes more and more like an actual baby which you have to feed, that keeps you awake at night, and that eats away a lot of your time. But, since it’s your baby, you won’t give up on it. So you push forward.
« En finir avec Word ! Pour une analyse des enjeux relatifs aux traitements de texte et à leur utilisation »
en fait, je n’utilise pratiquement plus du tout de traitement de texte. Pratiquement que des éditeurs #MarkDown : rapides, légers, efficaces…
Le truc pénible que j’affronte en ce moment, ce sont les différentes syntaxes de type markdown qui existent, du bbcode à mediawiki en passant, donc, par markdown (essentiellement sur les usines git*).
En fait, j’aimerais bien que mediawiki se mette à faire du markdown... ou l’inverse... :-)
Trouvé par Sylvain : « Drag and drop tools are just simpler. That’s a fact.
That’s why I’m working on a drag and drop alternative to Microsoft Word. To get started, just open up the dictionary panel, find the word you like and drag it onto the document. »
▻https://twitter.com/markdalgleish/status/1172260389158977536
Pour convertir les dialectes #Markdown entre eux (mais aussi d’autres « formats ») j’utilise #pandoc
Pandoc - About pandoc
▻https://pandoc.org/index.html
If you need to convert files from one markup format into another, pandoc is your swiss-army knife. Pandoc can convert between the following formats:
(← = conversion from; → = conversion to; ↔︎ = conversion from and to)
Well. Je trouve #markdown super ... pour exporter du html. Dès qu’il s’agit d’aller vers d’autres formats, ça demande d’installer tellement de dépendances pour avoir quelque chose de propre (par exemple des images redimensionnées à la taille du fichier d’export) qu’à ce stade, je finis toujours par copier coller dans libreoffice mon document pour pouvoir le transmettre à d’autres. (j’utilise uberwriter, mais c’est vrai aussi pour les autres soft testés (atom...).
@supergeante mais markdown c’est juste pour rédiger l’intérieur des chapitres, forcément ça fait pas tout. Dans l’idée d’un workflow complet du genre Syntaxe légère => web => print, il faut forcément coupler avec d’autres outils, pour contrôler finement les images ou autres choses non texte de ce genre. À priori avec un langage de template qui fait vraiment tout ce qu’il y a « autour » de la transformation pur du texte, càd faire le plan, l’entourage des chapitres, retailler les images, etc.
Nous actuellement on ne fait pas ça avec markdown mais avec SPIP, mais le principe reste le même. Du coup ya la syntaxe légère SPIP, mais aussi les modèles d’insertion d’images aussi. La syntaxe légère est transformée comme pour markdown, mais donc il y a un squelette qui s’occupe de mettre tous les chapitres ensemble et produire le HTML final. Qui ensuite est mis en forme avec une CSS print (avec tous les trucs modernes).
Là on fait tout nous-mêmes, pour tout contrôler, mais on peut très bien imaginer que des outils comme Pandoc ou autre fasse aussi ce travail. Je veux dire, c’est à ce morceau du workflow (après la gestion de la syntaxe légère) de retailler les images, et si ça manque, faut leur demander. :)
– Syntaxe légère, organisé en chapitres (tout dans le même document, ou bien dans plusieurs fichiers, ou comme nous dans une base de données avec nos objets « Chapitres » de SPIP)
– La syntaxe légère est transformée en HTML
– Un autre outil, langage de template ou autre, s’occupe de composer le document complet avec vraiment tout (sommaire, pied de pages, travail des images, etc).
– On a alors un unique HTML complet
– Qui est soit transformé en PDF à partir d’une CSS, soit en ODT, ou autre encore (mais c’est toujours à partir du HTML qui est pivot à priori)
Alors, (presque) tout pareil... sauf que la syntaxe en entrée n’est pas du tout légère : c’est du XML/TEI issu de la numérisation d’ouvrage papier. ▻https://github.com/DrozNumerique/zord-library
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
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.
Je suis aussi habituellement sous Typora, mais ce machin a l’air d’aller au-delà du simple éditeur MarkDown, notamment comme organiseur #Zettelkasten de notes et fragments, sans compter le fait qu’on peut aussi l’utiliser comme IDE, avoir des dossiers virtuels ou des dossiers de projets.
J’essaie de comprendre toutes les fonctionnalités et plus particulièrement le Zettelkasten.
Pour les liens, il y a des paramétrages prévus pour cela.
HackMD - Collaborative markdown notes
▻https://hackmd.io
Un éditeur Markdown en ligne avec double fenêtre, barre d’outils... (parmi les nombreux outils équivalents)
C’est pas tant un éditeur Markdow, mais surtout un pad collaboratif comme etherpad avec multiédition, historique et couleur de qui a écrit. Mais en mieux (d’après nous), plus léger, plus stable, et donc tout en markdown, et avec des syntaxes additionnelles genre Graphviz, on peut générer de l’UML, des Gantt, etc.
Ah et aussi : on peut l’installer chez soi, ça s’appelle CodiMD :
▻https://github.com/hackmdio/codimd
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
Il y a 3 ans… avec détails et roadmap des choses à faire dans l’ordre :
►https://core.spip.net/issues/3720
« 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 )
Notez qu’on peut faire à peu près la même chose avec SeenThis. La différence n’est pas trop dans la technique mais plutôt dans le fait que SeenThis est surtout utilisé pour signaler des trucs qu’on a vu (articles…), alors que Write.as semble plutôt utilisé pour publier des textes originaux.
@BigGrizzly Euh ? Moi, je n’ai rien vu de tel, et @aris non plus, il aurait râlé. L’examen du code source ne montre rien de googlesque. C’est pas une politique locale de ton navigateur, plutôt ?
Alors, rien vu sur writefreely, en effet, mais c’est lorsque je suis allé voir comment s’inscrire sur write.as que j’ai trouvé ça :
▻https://write.as/new/blog
@BigGrizzly Ah, à la création du compte ? Alors, là, je n’ai pas fait attention mais il y avait un CAPTCHA en effet. Je croyais qu’on parlait du simple lecteur.
@BigGrizzly @stephane
De mémoire, le captcha Google ne me dit rien... Je pense que c’est juste présent pour la création de blogs par les comptes gratuits
Avec Write.as/Write Freely tu peux suivre un blog depuis Mastondon, mais tu peux aussi partager directement un article en collant son URL dans le champs de recherche... Comme on peut le faire avec n’importe quel pouet...
Pros and Cons of Using #markdown for Technical Writing
▻https://hackernoon.com/pros-and-cons-of-using-markdown-for-technical-writing-34f277418a8a?sourc
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>
Mark Text
▻https://marktext.github.io/website
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.
Ouh là comment cela a l’air vraiment trop bien cette affaire. Il faudrait que je trouve un peu de temps pour le tester un peu sur la longueur (textes longs et foisonnants). Un jour. Je mets de côté donc.
Moi aussi je n’ai pas encore teste. En fait j’utilise Typora qui est vraiment très bien, mais qui n’est pas libre...
@aris Et moi j’utilise Word (comme traitement de texte) qui n’est pas hyper libre non plus ! Un jour.
Eh bé, encore et encore un… (suivre le tag markdown). Ça a l’air cool que ce soit en wysiwyg (souvent ya deux panneaux). Même si en electron donc possiblement un peu lent à la détente suivant les ordis. À tester
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
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
Ah je regardais si ça pouvait être chiffré parce que moi j’avais commencé à utiliser Skrifa que tu avais seené aussi @monolecte, justement parce que ça pouvait être chiffré (ce qui permet de copier le numéro de ma carte bleue, ou ce genre d’info).
Apparemment il semblerait qu’on puisse aussi là, tout en ayant un stockage où on veut (alors que Skrifa que en local je crois) :
▻https://joplin.cozic.net/e2ee
Après test : ça permet effectivement de chiffrer les données stockées, et donc ça concerne le stockage local ou l’envoi sur un stockage distant.
MAIS, par contre, ça enregistre la clé de chiffrement dans le logiciel ou un truc dans le genre, ce qui fait que quand on ouvre le logiciel sur la machine où c’est installé : tout est directement lisible ! Ça ne demande pas à retaper le code ! (Ce que fait Skrifa à chaque démarrage.)
Du coup pas super quand ya des infos sensibles ou persos dedans… :(
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
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
ah ouais ça a l’air cool
C’est un peu long chiffré, pour chaque action d’ouverture, sauvegarde, etc. Mais sinon ça a l’air de bien marché. Faut pas avoir à passer super souvent d’une note à une autre en permanence sinon c’est un peu chiant. Ou alors faut prendre la version sans chiffrage, qui est très rapide.
Un peu relou sur Ubuntu, je ne me souvenais plus du nom, et il n’y aucune méta-données associées au logiciel. Du coup quand dans le menu tu tapes « notes » ou « write » ou ce genre, tu ne trouves rien, il ne sort jamais. J’ai dû repasser par Seenthis pour retrouver ton seen, afin de rouvrir mes notes… :D
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.
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
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!
What is a Headless CMS? | CSS-Tricks
▻https://css-tricks.com/what-is-a-headless-cms
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.”
Documentation generator for shell scripts (bash, sh, zsh) ▻https://github.com/reconquest/shdoc
A command-line based markdown presentation tool.
►https://github.com/visit1985/mdp