asciidoctor.js
markup
Our great sponsors
| asciidoctor.js | markup | |
|---|---|---|
| 2 | 9 | |
| 708 | 5,778 | |
| 3.4% | 0.5% | |
| 6.8 | 2.0 | |
| 6 days ago | 23 days ago | |
| JavaScript | 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.
asciidoctor.js
-
ASCIIDoc Preprocessor for Use With SvelteKit?
I've been looking around for a ASCIIDoc preprocessor a la svelte-preprocess-markdown. I'm pretty sure I could accomplish it with marked extensions (or I could try and write my own preprocessor with asciidoctor.js) but I'm wondering if anyone knows of some additional resources that might help.
-
Compare AsciiDoc and Markdown
As can be seen here, GitHub renders Asciidoc just fine: https://github.com/asciidoctor/asciidoctor.js
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?
marktext - 📝A simple and elegant markdown editor, available for Linux, macOS and Windows.
org-mode - This is a MIRROR only, do not send PR.
asciidoctor-web-pdf - Convert AsciiDoc documents to PDF using web technologies
gitlab-foss
asciidoctor-mathematical - An extension for Asciidoctor that converts the content of STEM blocks and inline macros using Mathematical.
libasciidoc - A Golang library for processing Asciidoc files.
commonmark-spec - CommonMark spec, with reference implementations in C and JavaScript
aasvg - Turn ASCII art into SVG
cmark-gfm - GitHub's fork of cmark, a CommonMark parsing and rendering library and program in C
Mermaid - Edit, preview and share mermaid charts/diagrams. New implementation of the live editor.
pandoc - Universal markup converter