step-ca-on-rpi
markup
step-ca-on-rpi | markup | |
---|---|---|
1 | 9 | |
6 | 5,781 | |
- | 0.2% | |
2.5 | 1.8 | |
11 months ago | 26 days ago | |
Dockerfile | Ruby | |
MIT License | MIT License |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
step-ca-on-rpi
-
Include diagrams in your Markdown files with Mermaid
I use Monodraw on macOS and then embed the ASCII art into the Markdown in my README.
For example, https://github.com/mafrosis/step-ca-on-rpi#sso-for-ssh
I'd usually commit the source .monodraw files to the repo, but for some reason I didn't in that example repo :/
markup
-
Give your brain time to think and remember
Btw github supports more than just markdown: https://github.com/github/markup#markups
-
Documentation generators and custom syntax highlighting
I'm not sure 4. works for colors/styling, style attributes are stripped: https://github.com/github/markup/issues/119
- Do you think we will see color text in GFM?
-
Hiding front matter block in github markdown
I found this issue, which does not show much traction: https://github.com/github/markup/issues/994
-
Hi DM's, what medium do you use to organise your campaign?
For sharing settings and lore with players, GitHub wiki. Understands Org and several other formats thanks to GitHub Markup, so I can copy in (and trim down) my original notes without much fuss.
- raw-markdown and rendered markdown
-
Include diagrams in your Markdown files with Mermaid
Re: https://github.com/github/markup/issues/533
I’m the main author of KeenWrite (see screenshots), a type of desktop Markdown editor that supports diagrams. It’s encouraging to see that Mermaid diagrams are being supported in GitHub. There are a few drawbacks on the syntax and implications of using MermaidJS.
First, only browser-based SVG renderers can correctly parse Mermaid diagrams. I’ve tested Apache Batik, svgSalamander, resvg, rsvg-convert, svglib, CairoSVG, ConTeXt, and QtSVG. See issue 2485. This implies that typesetting Mermaid diagrams is not currently possible. In effect, by including Mermaid diagrams, many documents will be restricted to web-based output, excluding the possibility of producing PDF documents based on GitHub markdown documents (for the foreseeable future).
Second, there are numerous text-to-diagram facilities available beyond Mermaid. The server at https://kroki.io/ supports Mermaid, PlantUML, Graphviz, byte fields, and many more. While including MermaidJS is a great step forward, supporting Kroki diagrams would allow a much greater variety. (Most diagrams produced in MermaidJS can also be crafted in Graphviz, albeit with less terse syntax.)
Third, see the CommonMark discussion thread referring to a syntax for diagrams. It’s unfortunate that a standard “namespace” concept was not proposed.
Fourth, KeenWrite integrates Kroki. To do so, it uses a variation on the syntax:
``` diagram-mermaid
-
Footnotes now supported in GitHub Markdown
I thought it only rendered files in the repo (match by extension). Does GH also allow asciidoc(tor) syntax in comments and issues?
* Note: Sadly, include is not supported on GH. https://github.com/github/markup/issues/1095
- Compare AsciiDoc and Markdown
What are some alternatives?
aasvg - Turn ASCII art into SVG
org-mode - This is a MIRROR only, do not send PR.
kroki - Creates diagrams from textual descriptions!
gitlab-foss
asciitosvg - Create beautiful SVG renderings of ASCII diagrams.
libasciidoc - A Golang library for processing Asciidoc files.
obsidian-releases - Community plugins list, theme list, and releases of Obsidian.
commonmark-spec - CommonMark spec, with reference implementations in C and JavaScript
asciiflow - ASCIIFlow
Zettlr - Your One-Stop Publication Workbench
cmark-gfm - GitHub's fork of cmark, a CommonMark parsing and rendering library and program in C