djot
mdBook
djot | mdBook | |
---|---|---|
43 | 101 | |
1,580 | 16,669 | |
- | 1.5% | |
5.8 | 8.6 | |
2 months ago | 15 days ago | |
HTML | Rust | |
MIT License | Mozilla Public License 2.0 |
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.
djot
-
LaTeX and Neovim for technical note-taking
I know this doesn't solve your problem directly, but I recommend people to try out Djot[0], a markup language from the author of CommonMark.
Djot has a single well-defined spec, and most of the basic formatting has the same syntax as (a) Markdown, so switching is pretty painless. It has as a main goal to be legible and visually aesthetic as-is, just like Markdown.
What Djot adds is its _predictability_. Nested formatting, precedence order, line breaks behavior, nested blocks, mixed inline and block formatting, custom attributes are all laid out precisely in the spec in a thought-out manner. Till this day I still can't remember how to put line break within a list item in Markdown (and I'm sure there're more than one way).
[0]: https://djot.net/
- Pandoc 3.1.12 Released
-
Pandoc
Worth noting that the author has also created a markup language, djot.
https://github.com/jgm/djot
-
Augmenting the Markdown Language for Great Python Graphical Interfaces
Every time I see people doing something with Markdown, I wish they just replace it with support for Djot[0] instead. It is a Markdown alternative by the creator of Pandoc and CommonMark that fixes all of the most egregious mistakes, while being legible and visually pleasant as-is. It is also syntactically similar to Markdown, which should ease adoption.
[0] https://github.com/jgm/djot
- Djot is a light markup syntax
- Beyond Markdown
-
HELP!!! Stuck forever
Are you using markdown? It might make sense to look at 'djot' as well: https://djot.net/; it's a new 'light' markup language conceived as a successor to commonmark; development is led by none other than John McFarlane (author of pandoc, & also led commonmark standardization) Djot makes it really easy to attach arbitrary attributes to block elements as well as inline elements; and the parser records source positions in the output -- all of which makes it really convenient keeping track of elements changing position or value.
-
Is there a way to send data from neovim in real-time to other applications? Want to create a neovim qmk bridge.
I have a simple script that sends a djot buffer (https://github.com/jgm/djot) to the parser, if there's a change, on the CursorHold event.
-
wiki.vim v0.6 is released
Since you mentioned you were considering moving to CommonMark, have you had time to look into Djot (also by jpm)? Djot is meant to be easier to parse, and I'm planning to write a tree-sitter grammar for it.
-
Typst, a modern LaTeX alternative written in Rust, is now open source
Another recent development here is https://djot.net/ (by the pandoc author). It indeed thoroughly solves both:
mdBook
- Everything Curl
- Doks – Build a Docs Site
-
Ask HN: How do you organize software documentation at work?
I'm responsible for a number of Java products. I try to provide high-quality Javadoc for all public library interfaces, library user's guides where appropriate, and development guides for applications. The latter two take the form of MDBook documents (https://rust-lang.github.io/mdBook/), with the document source living in the GitHub repo so that it's tied to the particular software release in a natural way.
-
Outline: Self hostable, realtime, Markdown compatible knowledge base
My org has used mdBook: https://rust-lang.github.io/mdBook/ (That link is itself a rendered mdBook, so that'll give you an idea of the feature set.)
(While it's definitely a Rust "thing", if you just have a set of .md files, all you need is a "SUMMARY.md" (which contains the ToC) and a small config file; i.e., you don't have to have any Rust code to use it, and it works fine without. We document a large, mostly non-Rust codebase with it.)
-
Ask HN: Best tools for self-authoring books in 2023?
If you want the lowest friction, open source, easily extensible Markdown to Web, Kindle, PDF, etc. tool, highly recommend mdBook: https://github.com/rust-lang/mdBook it’s written in Rust, but you don’t have to know any Rust to use it. And then wing is all CSS; for which there are many good (free) themes.
- Early performance results from the prototype CHERI ARM Morello microarchitecture
- FLaNK Stack for 4th of July
- MdBook – A command line tool to create books with Markdown
- MdBook Create book from Markdown files. Like Gitbook but implemented in Rust
What are some alternatives?
typst - A new markup-based typesetting system that is powerful and easy to learn.
gitbook - The open source frontend for GitBook doc sites
Zato - ESB, SOA, REST, APIs and Cloud Integrations in Python
MkDocs - Project documentation with Markdown.
scroll - Tools for thought. An extensible alternative to Markdown.
Wiki.js - Wiki.js | A modern and powerful wiki app built on Node.js
pdfsyntax - A Python library to inspect and modify the internal structure of a PDF file
bookdown - Authoring Books and Technical Documents with R Markdown
pdfquery - A fast and friendly PDF scraping library.
obsidian-releases - Community plugins list, theme list, and releases of Obsidian.
PyMuPDF - PyMuPDF is a high performance Python library for data extraction, analysis, conversion & manipulation of PDF (and other) documents.
Docusaurus - Easy to maintain open source documentation websites.