mexdown
markup
Our great sponsors
| mexdown | markup | |
|---|---|---|
| 2 | 9 | |
| 13 | 5,778 | |
| - | 0.5% | |
| 10.0 | 2.0 | |
| about 4 years ago | 22 days ago | |
| Go | 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.
mexdown
-
Include diagrams in your Markdown files with Mermaid
I like this approach of using the tag associated with a code block to determine how to render the output. It's the same approach I take in my markdown-derived markup language: https://github.com/smasher164/mexdown.
The top example there takes a GraphViz description and passes it into the dot command, placing the resultant SVG into the HTML output.
-
Show HN: JWEB (a modern implementation of the CWEB Literate Programming system)
This is similar to the approach I take in my markup language: https://github.com/smasher164/mexdown. Pipe the body of a code block to the command's stdin, and replace the code block with its output.
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?
Mermaid - Edit, preview and share mermaid charts/diagrams. New implementation of the live editor.
org-mode - This is a MIRROR only, do not send PR.
aasvg - Turn ASCII art into SVG
gitlab-foss
jweb - The JWEB system of Literate Programming
libasciidoc - A Golang library for processing Asciidoc files.
RawParser - Showing how a grammar driven parser can be implemented
commonmark-spec - CommonMark spec, with reference implementations in C and JavaScript
asciitosvg - Create beautiful SVG renderings of ASCII diagrams.
cmark-gfm - GitHub's fork of cmark, a CommonMark parsing and rendering library and program in C
marktext - 📝A simple and elegant markdown editor, available for Linux, macOS and Windows.