mastodon.xyz is one of the many independent Mastodon servers you can use to participate in the fediverse.
A Mastodon instance, open to everyone, but mainly English and French speaking.

Administered by:

Server stats:

854
active users

#commonmark

0 posts0 participants0 posts today

Getting close to being happy with how I organise the content for a module I have been entrusted with.

It is a #Git organised set of notes for a #flippedClassroom module.

All notes are written in #CommonMark (#OrgMode if it was just me ;-))

#Pandoc is at the heart of preparing the written notes.

+ Custom templates help satisfy local branding requirements
+ Pandoc features enable #moodle compatible HTML to be generated with #MathJax maths and embedded resources. (Moodle is just a carrier!)
+ Use #CSL to generate references

#Make enables targets to generate ALL THE TARGETS, ensuring correct pandoc options are used:

+ Standalone HTML for local use, with #SimpleCSS for styling
+ HTML optimised for Moodle;
+ LaTeX;
+ PDF (via LaTeX)
+ DOCX

Slides and assessment specs are still LaTeX.

Continued thread

Ja, das gefällt mir schon besser.
#CommonMark / #ShowDown ist schlank, lässt sich gut in #Moodle verwenden und produziert einen style-baren HTML-Code.

Was müsste man tun, damit das die hakelige Markdown-Implementierung offiziell ersetzen kann? Immerhin funktioniert ShowDown auch serverseitig. 🤔

Was mir jetzt noch fehlt, ist ein "Präsentationsmodus" für das Textfeld. ...
Vorerst wird das wohl nichts mehr, aber LisScript und Cryptpad können es ja immerhin auch, also sollte da doch irgendow ein Weg sein.

Continued thread

#LiaScript möchte mit seinem zentralen Interpreter offenbar weg von #LMS wie #Moodle und sieht sich selbst als "Open-courSe" -System, das per iframe oder SCORM eingebunden werden kann.

Die #Markdown - Quelldateien liegen dabei bei Github, Dropbox oder Nextcloud.

Ein Moodle-LiaScript-Plugin dagegen gibt es nicht. 🤔 Schade.

Dann bleibt also noch der handgemachte Weg über Javascript:

- #CryptPad Presentation / Slides lassen sich themen, und dies basiert auf #CodeMirror, was noch nach Arbeit aussieht. codemirror.net/5/mode/markdown

- #CommonMark ist standardisiertes Markdown, und mit #ShowDown immerhin einbettbar. demo.showdownjs.com/

codemirror.netCodeMirror: Markdown mode

#Markdown syntax tip for code block attributes, yielding the best rendering results with both pandoc and on platforms such as #GitLab #GitHub, #Codeberg, etc:

``` lua {#my-id .another-class}
io.stdout:write('hi!')
```

The curly-braces syntax for attributes is ignored when read as #CommonMark, the Markdown variant used by most platforms. The above ensures that syntax highlighting still works with CommonMark, and that the other attributes get respected when converting with #pandoc.

Support for #CommonMark alert-boxes was added in pandoc 3.1.10.

> [!INFO]
> This is an informational message.

Note, however, that writer (i.e., rendering) support for this is limited, and that the `alert` extension works with CommonMark, but not with pandoc-flavored Markdown.

The syntax has been made popular by GitHub: docs.github.com/en/get-started

GitHub DocsBasic writing and formatting syntax - GitHub DocsCreate sophisticated formatting for your prose and code on GitHub with simple syntax.

I'm still not out of the rabbit hole of searching for an #OpenSource #PersonalKnowledgeManagement software. 🐰

I'm gonna give a second try to @zettlr tomorrow! Their docs are *surprisingly* user-friendly and they claim to stick to the pure #CommonMark where probable. It's all the while being nice to researchers with citing, inline usage of #TeXLaTeX, #MermaidJS, and pop-over #footnotes. Provision of the simple #PDF export and #Pandoc customization are welcome, too!

But, to be fair, I may be overexaggerating how good #Zettlr is because of my recent disgust with #VendorLocking. In fact, almost anything that closely follows the common spec and is #FreeSoftware might suffice already. Having something as advanced and closer to the roots is certainly refreshing!

Replied in thread

@nixCraft Saying "GTFO" to pretty much every note-taking application that keeps adding its own stuff that's hard to overwrite, navigate and, worst of all, not compliant with #CommonMark, making viewing experience increasingly awful in programs from KWrite down to vim.

Sometimes, I have to wonder if an app like Logseq wants to justify its own 16th derivative standard for #Markdown, while keeping you locked-in to ecosystem of its maintainer. Sure, the intentions were bright, but after many years of no progress and no transparency you'd probably feel a bit uncomfortable with this grey box.

Replied in thread

@theory @Perl Yes. I didn’t dig into the other PRs; I just thought to point out that #CPAN already has a solution for outside dependencies in the Alien namespace and went looking there.

Unfortunately it seem the #Perl #CommonMark maintainer resisted four years ago and let the PR languish. The repo itself has also not seen any commits since then either.

So good luck to all concerned. Maybe reach out directly per #PAUSE: pause.perl.org/pause/query?ACT

pause.perl.orgPAUSE: The CPAN back stage entrance

#Markdown / #CommonMark feature—unprefixed lines become part of the previous bullet list item or block quote:

* List item
Unindented line

<ul>
<li>List item
Unindented line</li>
</ul>

> Quoted line
Unprefixed line

<blockquote>
<p>Quoted line
Unprefixed line</p>
</blockquote>

Try it out online: spec.commonmark.org/dingus/

Do you use this feature?

spec.commonmark.orgcommonmark.js demo

#Pandoc 3 introduced #Markdown support for #wikilinks:

[[pandoc|https:/‌/github.com]]

There is no consensus across tools whether the link title should come before or after the pipe character, so pandoc supports both. Choose by enabling either of the new extensions
+wikilinks_title_after_pipe
or
+wikilinks_title_before_pipe

Works with #CommonMark, too: for GitHub wiki input, use gfm+wikilinks_title_after_pipe