Markdown-based publishing tools / frameworks

[rufuspollock]

This is a bit of a laundry list ...

Some of this may split out to their own item ...

Bullet list

Paid and proprietary

• gitbook
• readme.io

Various with more detail

2024-04-05

https://retype.com

Retype is an ✨ ultra-high-performance ✨ static website generator that builds a website based on simple Markdown text files. Focus on your writing while Retype builds the rest.

2022 list

https://frontmatter.codes - 2022-06-29

CMS in VS Code. This is more like an alternative to obsidian or a local version of tina.io.

Headless CMS running in VS Code

Front Matter is a CMS that runs within Visual Studio Code. It gives you the power and control of a full-blown CMS while also providing you the flexibility and speed of the static site generator of your choice. Jump right into editing and creating content with Front Matter and be able to preview it straight in VS Code.

Nextra (2022)

https://github.com/shuding/nextra 3.6k⭐

https://nextra.vercel.app

The Next.js Static Site Generator

Comments:

• Main thing is more of a side project of two core members at vercel. Not that updated since ~1y ago (v2 planned but not sure it is happened)

SectorTools

• https://twitter.com/sectortools - seems to have launched 2020 and been inactive since 2021

Obsidian specific (2022)

2022-07-11 Obsidian Digital Garden

https://github.com/TuanManhCao/digital-garden 160⭐

Free Obisidian Publish alternative, for publishing your digital garden.

obsidian digital garden - 2022-07-02

https://github.com/oleeskild/obsidian-digital-garden

Looks like started around 7m ago in early 2022. Has 100 ⭐ and about 1600 installs in obsidian as a plugin.

Obsidian Publish

...

Obsidian Quartz

Note

In 2023 think Quartz updated to be JS based (and even NextJS based?)

https://github.com/jackyzha0/quartz 609 ⭐

"Hosting a public digital garden isn't easy. There are an overwhelming number of tutorials, resources, and guides for tools like Notion, Roam, and Obsidian, yet none of them have super easy to use free tools to publish that garden to the world. ... The goal of Quartz is to make hosting your own public digital garden free and simple. You don't even need your own website. Quartz does all of that for you and gives your own little corner of the internet."

• uses hugo and oriented to obsidian as uses github.com/jackyzha0/hugo-obsidian@latest

• Here is it mentioned plus a youtube howto video in April obsidian roundup https://www.obsidianroundup.org/2022-04-02/ "Here's how to use Quartz as a free Publish alternative"

[davidgasquez]

Adding a few more tools, focused on data publishing.

Evidence

https://evidence.dev/

Evidence is a lightweight framework for building data apps. It's open source and free to get started.

Observable Framework

https://observablehq.com/framework/

A static site generator for data apps, dashboards, reports, and more. Observable Framework combines JavaScript on the front-end for interactive graphics with any language on the back-end for data analysis.

Genji MD

https://genji-md.dev/

The Markdown extension for interactive documents, available in VitePress.

[rufuspollock]

@davidgasquez great additions.

[rufuspollock]

I and @davidgasquez have started an awesome repo here for this https://github.com/datopian/awesome-markdown-authoring

Some quick reflections - love your thoughts @davidgasquez

• awesome repo approach has advantage of simplicity and ease of contribution ...
• BUT ... i really miss screenshots and more info
• i'm wondering if there some kind of "middle way" where we have a repo with each item as its own page or section and then we can display that nicely ...

[davidgasquez]

I think we could add the screenshots. The only thing I'd keep different from this discussion is the image size. We could cap it at 300px.

Something like this:

Project Name

Short description of the project/tool.

Project Name

Short description of the project/tool.

[rufuspollock]

@davidgasquez I think this is great 👍

And do we keep working in awesome repo i assume and see how that goes - i assume so (?)

[davidgasquez]

Yes! Let's keep working on the awesome repository and see how that goes! 😊

[rufuspollock]

@davidgasquez do we keep this separate or merge into our new data collective notes repo ...

[davidgasquez]

Let's merge it to our notes!