Stripe Open Sources Markdoc

1. docs

   1 2 132 5.4 JavaScript

   Documentation site for Markdoc (by markdoc)

   

   One curiosity: I was trying to figure out how the diagram at the top of https://markdoc.io/docs/render was generated.

   The items inside the diagram seem curiously absent from the source of the page: https://raw.githubusercontent.com/markdoc/docs/main/pages/do...

   Instead, when the `diagram` tag is defined, it maps the "type" parameter to a particular diagram: https://github.com/markdoc/docs/blob/main/components/Diagram...

   Any reason it is done that way, rather than specifying the diagram in the source of the document using mermaid, pikchr, etc?

2. CodeRabbit

   coderabbit.ai featured

   CodeRabbit: AI Code Reviews for Developers. Revolutionize your code reviews with AI. CodeRabbit offers PR summaries, code walkthroughs, 1-click suggestions, and AST-based analysis. Boost productivity and code quality across all major languages with each PR.

   

3. mkdocs-material

   2 100 22,557 9.6 Python

   Documentation that simply works

   

   For anyone looking for a doc generation tool:

   I was lately evaluating several tools like VuePress, Docusaurus and AsciiDoc.

   I ended up using Mkdocs Material (https://squidfunk.github.io/mkdocs-material/). If you haven't already, have a look. I think it is pretty impressive. From tags, tabs to the fantastic built-in search ...

4. docs

   3 1 134 9.1 JavaScript

   Source code for the Streamlit Python library documentation (by streamlit)

   

   I don't understand how this is fundamentally different than MDX, which can already mix React components within Markdown.

   We used it to build the Streamlit docs. I assumed this is how everyone was doing documentation: https://github.com/streamlit/docs

5. mdx

   4 108 18,209 8.4 JavaScript

   Markdown for the component era

   

   I haven't heard of MDX before, but this looks fantastic. The API looks more intuitive than Markdoc. https://mdxjs.com/ for anyone else wanting to learn more.

6. markdoc

   5 1 89 10.0 Stata

   A literate programming package for Stata which develops dynamic documents, slides, and help files in various formats (by haghish)

   

7. Docusaurus

   6 300 58,886 9.6 TypeScript

   Easy to maintain open source documentation websites.

   

   mdx is great, especially if your team is already fluent with react/jsx. You might also be interested in docusaurus https://docusaurus.io/ as it has support for mdx built in.

8. instaunit

   7 2 24 7.2 Go

   A tool for testing and documenting Web APIs

   

   Shameless plug: for REST APIs, I've written a tool called Instaunit which combines HTTP API integration tests with documentation generation, since these two things must always be maintained in lockstep.

   It's got a ways to go before it generates output that looks as good as Stripe's documentation, but it makes it dead simple to create API documentation that's guaranteed to be in sync with your service, because it was generated by your tests when they ran.

   https://github.com/instaunit/instaunit

9. SaaSHub

   www.saashub.com featured

   SaaSHub - Software Alternatives and Reviews. SaaSHub helps you find the best software and product alternatives

   

10. HedgeDoc

    8 50 5,612 9.5 TypeScript

    HedgeDoc - Ideas grow better together

    

11. mm-docs

    9 2 20 4.5 PowerShell

    Documentation system in a docker container using mkdocs, plantuml and many more

    

    I am glad to know there are those that put so much thought into documentation. Documentations is just another service, and deserves all the same methodology: CI/CD, tests, components, reuse etc.

    As far as I can see, you can get similar workflow with combination of existing tools. I created this docker image that combines them for very easy consumption and created thousands of pages of technical, functional and user documentation with it:

    https://github.com/majkinetor/mm-docs

12. remark

    10 46 8,032 7.7 JavaScript

    markdown processor powered by plugins part of the @unifiedjs collective (by remarkjs)

    

    As someone who was about to use Remark (https://github.com/remarkjs/remark) and Next.js to start a new blog, does this solve something that Remark doesn't? Genuinely curious.

13. rst2nitrile

    11 1 7 10.0 Python

    convert rst to latex books

    

    Last week I ported my static physical book building tooling from rst-based [0] to markdown (pandoc filter) based.

    I've used my rst tooling to publish many books (like Effective Pandas) and am wanting to drop rst in an effort to simplify my life. My pandoc toolchain is not in github yet, but preliminary exploration validates that I can publish my next physical book with it (with things like front matter, indices, etc).

    In the process I messed around with MyST and mistletoe. I dropped MyST because it was evident I would need to mess around with Sphinx again. Been there done that. Too much abstraction.

    Mistletoe would have worked too (I need to create custom fences/markup for a few features) but I wanted to see if I could do it with Pandoc.

    The Pandoc distinction between Blocks and Inlines is annoying as is the requirement to handle everything at once. With Pandoc, you only get notified at the start of an element, not the end which probably complicates it a bit more than Mistletoe would have.

    (I still need to port my slide generation tooling and will probably use mistletoe for that. For epub generation I think I will stick with Pandoc.)

    0 - https://github.com/mattharrison/rst2nitrile

14. esbuild-markdoc-plugin

    12 3 14 0.0 JavaScript

    esbuild plugin for markdown files using markdoc

    

    If anyone is interested, I published my esbuild plugin so you don’t have to transform on the server if you want to just import a markdown file.

    https://github.com/toddw/esbuild-markdoc-plugin

15. stripe

    13 8 2,246 8.7 Go

    Go library for the Stripe API.

    

    Unfortunately my experience has been different; I found that Stripe's Go doc doesn't match their API and while searching on it I found that someone else had mentioned that to their personnel over freenode 2 years ago.

    So I raised an issue on GitHub[1] on Apr 9 and hasn't been attended to yet.

    On a more serious note, Stripe's payment links doc seemed to imply that tax rates are automatically calculated if the tax rates are set(as we do with code when we pass the tax_id), But I found after couple of payments that tax aren't being charged, On conversing on Twitter with the payment links dev I came to realize that the required option was not there for me[2] and then after couple of hours with their support staff I was informed that the options was not available for India as 'Stripe Tax' is a separate product.

    Overall, I'm happy with Stripe's tech; at least compared to the other options I have. But their docs have caused me some frustrations.

    [1] https://github.com/stripe/stripe-go/issues/1447

    [2] https://twitter.com/joshuaackerman/status/144759582096702259...

16. python

    14 1 223 8.6 Python

    A Python handler for mkdocstrings. (by mkdocstrings)

    

17. crystal

    15 1 29 6.8 Python

    📘 Crystal language doc generator for https://github.com/mkdocstrings/mkdocstrings (by mkdocstrings)

    

18. mkdocstrings

    16 10 1,830 9.0 Python

    :blue_book: Automatic documentation from sources, for MkDocs.

    

    Author of Materia for MkDocs here. MkDocstrings [1] implements automatic generation of reference documentation from sources. It's language-agnostic, actively maintained and currently supports Python [2] and Crystal [3]. It also integrates nicely with Material for MkDocs.

    [1]: https://mkdocstrings.github.io/

19. fastapi

    17 531 82,407 9.9 Python

    FastAPI framework, high performance, easy to learn, fast to code, ready for production

    

20. SaaSHub

    www.saashub.com featured

    SaaSHub - Software Alternatives and Reviews. SaaSHub helps you find the best software and product alternatives

    

Suggest a related project