#markdown

danie10@squeet.me

Mermaid is an open source tool that can be used to create such charts using Markdown plaintext

A split screen view showing on the right a flowchart that starts out with a block saying Brainstrom article, which then points to a small block saying send pitch. On the left side is seen the plain text code that creates this chart. It shows a line A[Brainstorm article] -->|send pitch| etc and continues on.
Quickly create a flowchart, mindmap, or Gantt chart without once touching your mouse.

Open source means it is not going to suddenly disappear tomorrow, it can be broadly supported across different platforms and Markdown editors, and you can see what it is doing (not a binary storage blob).

Wherever a Markdown editor has support for Mermaid (often through a plugin) this type of chart and diagrams will work. For those who do tables in Markdown, Mermaid’s syntax will look familiar.

Plain text format means it will still be readable in 500 years time when Microsoft is long gone.

The linked article also gives a link to the online Mermaid site where you can test this out, or design your chart and then copy the code to your Markdown file.

See lifehacker.com/tech/mermaid-cr…
#Blog, #markdown, #opensource, #technology

citoyen_candide@diaspora-fr.org

Aide pour l'utilisation du schéma de lien Diaspora*

diaspolove

Bonjour,

Certaines personnes utilisatrices de Diaspora* rencontrent des difficultés ou appréhension dans l'utilisation de cet outils.

Je me propose de vous expliquer le #lienpermanent tel que définit par @Salinger. Il m'a fait comprendre ce fonctionnement, je tente à mon tour de le faire.

Pourquoi ?

Au fil de nos interactions avec d'autres sur Diaspora*, nous pouvons être amené•e à leur pointer certains posts.
La façon la plus simple de faire cela est de copier le lien url que l'on trouve dans la barre d'adresse de son navigateur.

Mais, étant donné la nature décentralisée de Diaspora*, une personne qui sera sur un autre pod ne pourra pas interagir avec ce post.

Par exemple, je peut pointer ce lien :
https://diaspora-fr.org/posts/4794302

(Au hasard, Balthazar. Surtout n'allez pas lire le contenu de ce post maintenant)

Ce lien est relatif au pod sur lequel je suis inscrit : diaspora-fr.org
Ça n'est pas forcément le pod sur lequel vous êtes inscrit vous même.

Ainsi, une personne inscrite sur diaspora.psycho.fr (ou n'importe quel autre pod) pourra voir le post en cliquant sur le lien, mais pas liker, commenter, repartager. Elle ne pourra pas interagir avec le post.

C'est ce problème particulier que solutionne le #lienpermanent.

Pointer les utilisateurs Diaspora* vers un post avec lesquel ils peuvent interagir.

Qui ?

Cette démarche implique de rédiger des liens en se servant de la mise en forme #markdown.
Ce sera donc à vous, utilisatrice ou utilisateur, de rédiger vos posts et/ou commentaire en utilisant la syntaxe adéquate.

Où ?

Sur vos posts et vos commentaires Diaspora*

Quand ?

Quand vous voudrez, quand vous vous sentirez prêt•e, quand vous aurez le temps, quand vous aurez envie de rendre Diaspora* encore plus convivial...

Quoi ?

De quoi parle t'on?
Nous parlons du diaspora:// URI scheme (page en anglais, désolé pour les francophones).
Pour faire simple, dans le principe, plutôt que d'aller piocher un post dans la liste de posts connus par un pod, cette syntaxe indique au navigateur comment aller chercher un post particulier (c'est important pour la suite).

Comment ?

Dans mon premier exemple, le lien donné utilise un identifiant local (4794302). Cette référence est propre au pod diaspora-fr.org et ne fonctionnera pas sur un autre pod. Du moins elle ne reverra pas sur le même post.

Il existe un autre identifiant de post, partagé entre tous les pods. Il s'agit du GUID (Global Unit IDentificator ?). On trouve cette longue suite de chiffres et de lettres d'au moins deux manières. Je décrit ça plus loin.

La mise en forme Markdown pour un lien, c'est :
[Alt text](lien_url)
Alt text est le texte que vous voulez voir apparaître
Et lien_url est l'adresse

Je l'ai utilisé dans ce post pour le lien diaspora:// URI scheme : j'ai écrit
diaspora:// URI scheme en guise de Alt text et copié le lien de la page voulue, placée entre les parenthèses.

Pour faire un lien permanent,

Il vous faut :
- Le GUID du post vers lequel vous voulez pointer,
- L'identifiant d'utilisateur. Celui de mon compte, c'est citoyen_candide@diaspora-fr.org

La syntaxe de lien permanent est la suivante
diaspora://author@pod/post/GUID

Ceci va venir entre les parenthèses dans la mise en forme Markdown.

On remplace author@pod par l'identifiant d'utilisateur. C'est celui de l'auteur du post que vous voulez partager.

On remplace GUID par le GUID du post en particulier que l'on veut partager.

J'attire votre attention sur le fait que cette syntaxe utilise post au singulier (.../post/...) et non posts au pluriel comme dans mon premier lien d'exemple (.../posts/...). C'est dû au fait qu'on va chercher un post particulier chez un auteur/utilisateur sur un pod en particulier et non un post dans une liste de posts.

Bon, mais là vous me dites: OK mais je trouve comment le GUID et l'identifiant utilisateur pour le post que je veut partager?

J'y viens.

Comme je l'ai dit plus haut, vous avez au moins deux méthodes.

À la souris :
Depuis un navigateur en mode non tactile, en survolant l'image de l'auteur, vous aurez son identifiant, il faut le surligner à la souris pour le copier.
Pour trouver le GUID, il faut passer sa souris à droite de l'heure du post.
Vous apercevrez une image en forme de chaine.
Copiez et coller le lien
Le GUID, c'est la longue suite de chiffre et de lettres.

Au clavier:
Dans la barre d'adresse de la page du post, ajoutez .json à la fin de l'adresse, puis entrer.
Vous verrez tous les champs qui composent une page de post diaspora, dont, au début, le GUID et plus loin, le diaspora_id, c'est l'identifiant utilisateur.

Voila, je crois que vous avez tous les éléments. Il ne vous reste plus qu'à passer à la pratique.

Pourquoi ne pas tenter de rédiger un post avec un lien permanent vers le présent post ?

P.S.: vos questions, commentaires, remarques sont les bienvenues.

danie10@squeet.me

The Best Obsidian Note Plugins, nor Not?

Obsidian's purple logo with title Obsidian, a symbol showing two plugs connecting, and sub-title Best Obsidian Plugins
I had not tried Omnisearch, but apart from that and Advanced Tables, the suggested ones are not really “my best ones”. But the linked article does again highlight one of Obsidian’s most powerful features – it’s community plugins. Many note takers are good Markdown editors, but few come close to rivalling Obsidian’s plugin power, largely created by the community themselves.

Even though free Obsidian is not open-source, it gained a lot of traction and users have created so many valuable plugins. I also like that it leaves all my Markdown formatted files in place where they are. One excellent open-source notes editor I tried, insisted on inserting an odd character at the start of every new line as it was intended an outliner, not a notes editor. Thing is, I like to keep my notes as standard as possible so that I can switch to another note taker in future.

The ones I find really useful are:

  • Advanced Tables
  • cMenu
  • Code block from selection
  • Copy Image and URL context menu
  • Dynamic Table of Contents
  • Excel to Markdown Table
  • Highglightr
  • Kanban
  • Kindle Highlights
  • Local Images
  • Markdown Formatting Assistant
  • Obsidian Enhancing Export
  • Omnisearch
  • Ozan’s Image Editor Plugin
  • Related Notes Finder
  • Tag & Word Cloud
  • Tag Wrangler
  • Text Format
  • txt as md (edits existing .txt files)
  • Underline
  • Vault Statistics

But we all have different requirements (like some wanting to play Zoom inside Obsidian, use AI, publish to Nostr, etc), so it is well worth browsing the community plugins and seeing what is of interest to you. There are around 1,180 plugins right now.

See https://www.alphr.com/best-obsidian-plugins/

If you’ve not seen Obsidian, I did quite a long video about it at https://www.youtube.com/watch?v=q_4LR76g-jU
#Blog, #markdown, #notes, #productivity, #technology

jaywink@jasonrobinson.me

Hey when did #Mastodon start getting #Markdown formatting? My posts from #Socialhome actually look almost as they should now, doing a random check from a Mastodon instance.

That "four images only" silly per post limit really should be lifted, most of my followers are probably on Mastodon and I always forget they wont see anything past the four images.

danie10@squeet.me

Beaver Notes: A Private Cross-Platform Open-Source Note-Taking App

Beaver Notes screen showing its yellow logo with the letter B on it, and the version number, and link to the website as well as Github project site. The column to the left shows Settings with options for General, Shortcuts and About. On the far left is a narrow vertical toolbar with various icons on it.
This app has a very similar look and feel to it as Obsidian, and also works in Markdown format. And although Obsidian has a kitchen sink full of community plugins, this app is a lot simpler, but it is proper open-source software.

I also like that it has a toolbar with all the usual shortcuts like bold, italics, underline, headings, bullets, etc as many people do like that ease of use, instead of only having to remember Markdown codes.

Very importantly for note taking, it does have easy-to-use tags that will help connect all your related notes. If you do need to sync your notes between devices, you could use something like Syncthing that will do that privately and directly between your devices, without any server required.

See https://news.itsfoss.com/beaver-notes/
#Blog, #markdown, #notes, #opensource, #technology

danie10@squeet.me

The Best Way to Bulk Export Your Apple Notes to More Portable Markdown Format

iPhone showing the Notes app open with words New Year Resolutions.
Apple Notes are only really usable inside Apple Notes. If you are regularly working across other operating systems, like I do, this can actually be inconvenient (Steve expects you to only work inside the Apple ecosystem). There is iCloud login, but the editing is not really optimised for the devices you use.

An alternative is to export your Apple Notes into Markdown format, which will allow you to use any Markdown editor across any device to edit those notes. The linked article below explains how to do that quite easily.

I’m using my own self-hosted Nextcloud server to sync my notes between all my devices, but you could also use Dropbox to start with, or any other sync service.

The nice things about the Markdown format are:
1. It’s an open standard which is future-proof in that it is not locked into any vendor service that disappears one day.
2. It’s free.
3. You can pick the best Markdown editor for each platform you’re using.

On my Linux desktop, I’m still using Obsidian as my Markdown editor, and the Ulauncher launcher allows me to quick search my Obsidian notes without even open the app.

See https://lifehacker.com/the-best-way-to-bulk-export-your-apple-notes-1850685680
#Blog, #AppleNotes, #markdown, #technology

magdoz@diaspora.psyco.fr

Tutoriels Diaspora*

Mise en forme du texte

Pour le #markdown. Aide aussi pour insérer une #image, du #code, une #citation...
(j'ai parfois du mal à retrouver cette page, alors là voici...) :

-- https://diasporafoundation.org/formatting

A. Un petit plus ?
-> Pour intégrer une image qui sera cliquable pour envoyer vers un URL :
1. lien image : ![](URL_image "")
2. lien cliquable : [Texte ou titre etc](URL_adresse "")
3. puis lien image cliquable -> combiner les 2 mises en forme : [![](URL_image "")](URL_adresse "")

B. Deuxième petit plus ?
Comment partager un lien absolu d'un post, facilement ?
Un lien court est de ce type : https://diaspora.psyco.fr/posts/0000000 (404 celui-là)
Il n'est pas suffisant. Sur cette page de post, il faut cliquer sur la date (attention, ça ne marche pas sur dandelion).
Sur pc, on tient alors un code plus long, de ce type : https://diaspora.psyco.fr/posts/39461890c1de013b19877054d219cb33
Ensuite, pour donner accès à commentaires, likes et partages à tous, il faut que chacun puisse y accéder de son pod !! Pour cela, il faut laisser vierge la zone d'adresse du pod dans l'URL, et par défaut, ainsi le pod de celui qui cliquera remplira le vide :
[Post à partager]( ̶h̶t̶t̶p̶s̶:̶/̶/̶d̶i̶a̶s̶p̶o̶r̶a̶.̶p̶s̶y̶c̶o̶.̶f̶r̶/posts/39461890c1de013b19877054d219cb33 "CLIC") et ça donne donc :
[Post à partager](/posts/39461890c1de013b19877054d219cb33 "CLIC")
Ce lien permettra à tous de liker, partager, et commenter le post.

Voir par ici aussi :
-- https://diasporafoundation.org/getting_started/sharing (pages avant et après, aussi)

Lien absolu pour partager ce post : voir mon premier commentaire dans le fil ! :)

#Aide #Diaspora #Tutoriel #Partage #Connaissance

navelbrush@pod.geraspora.de

#OER lebt ja von der Wiederverwendung und Ergänzung von Inhalten.

Eine Erstellung der Inhalte z.B. mit Word oder LibreOffice ist da aber nur sehr, sehr bedingt hilfreich...

Sind Auszeichnungssprachen ein Thema in der OER-Community?
Also die Verwendung von #AsciiDoc, #reStructuredText oder #MarkDown?

Oder betrachtet man mit Verwendung einer freien Lizenz das Thema als erledigt?

danie10@squeet.me

Obsidian Markdown Notes Editor to Build Your Personal Knowledge Base Into The Future

Bild/Foto
Obsidian is a free (non-commercial use), not open source, text editor and works with open standard Markdown formatting on plain text files.

Apart from quite advanced editing and UI options, I find Obsidian attractive because of its over 500 quality community plugins, and its ability to visually show the relationships between your notes. Recording notes from meetings, or as you are daily learning new things or solving problems, is an excellent way to build your personal knowledge base. Using Markdown format can be fun, and can achieve a lot in terms of readability when you use some of the more advanced features of Markdown formatting.

Despite not being open source, you are not locked into Obsidian, and can use other Markdown editors interchangeably. In my video, I also touch on integrating with NextCloud to sync your notes, and especially some issues that iOS presents for apps.

Watch my video at https://youtu.be/q_4LR76g-jU

#technology #obsidian #markdown #notes #editor
#Blog, ##editor, ##markdown, ##notes, ##obsidian, ##technology