1 - Mermaid Diagram Support Enabled!

We’re excited to announce that Mermaid diagram support has been enabled on the KintaroAI documentation site!

What’s New

You can now create beautiful diagrams and visualizations directly in your documentation using Mermaid syntax.

Example: Flowchart

graph LR;
  F[Get new task] --> A;
  A[Start] --> B{Is it working?};
  B -- Yes --> C[Great!];
  B -- No --> D[Fix it];
  D --> B;
  C --> F;

Example: Sequence Diagram

sequenceDiagram
  participant LLM Kun
  participant Gen Chan
  LLM Kun->>Gen Chan: Hey Gen Chan, how are you?
  Gen Chan-->>LLM Kun: ❤️

Example: Class Diagram

classDiagram
  class Transformer {
    +forward(input, target)
  }
  class Encoder {
    +int num_layers
    +encode(input)
  }
  class Decoder {
    +int num_layers
    +decode(target, encoder_output)
  }
  
  class MultiHeadAttention {
    +int num_heads
    +compute(query, key, value, mask)
  }
  
  class FeedForward {
    +forward(input)
  }
  
  class PositionalEncoding {
    +add(input)
  }
  
  class LayerNorm {
    +normalize(input)
  }
  
  Transformer *-- Encoder : contains
  Transformer *-- Decoder : contains
  Transformer *-- PositionalEncoding : uses
  
  Encoder *-- MultiHeadAttention : uses self-attention
  Encoder *-- FeedForward
  Encoder *-- LayerNorm : uses
  
  Decoder *-- MultiHeadAttention : uses masked self-attention
  Decoder *-- MultiHeadAttention : uses cross-attention
  Decoder *-- FeedForward
  Decoder *-- LayerNorm : uses

Try It Out

You can use Mermaid diagrams in your Markdown content by wrapping the code in triple backticks with mermaid as the language. See the Mermaid documentation and examples for more diagram types and syntax.

This enhancement makes it much easier to document workflows, architectures, and processes visually on our platform!

2 - KaTeX Math Support Enabled!

We’re excited to announce that KaTeX support has been enabled on the KintaroAI documentation site!

What’s New

You can now write mathematical formulas and chemical equations directly in your documentation using LaTeX syntax:

Inline Math

Use single dollar signs: \(E = mc^2\) \(E = mc^2\)

Block Math

Use double dollar signs for larger equations:

$$
\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
$$
$$ \int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi} $$

Chemical Equations

KaTeX can render chemical equations:

$$
2H_2 + O_2 \rightarrow 2H_2O
$$
$$ 2H_2 + O_2 \rightarrow 2H_2O $$

Try It Out

Visit our Math Test Page to see examples of mathematical formulas, chemical equations, and complex expressions in action.

This enhancement makes it much easier to document mathematical concepts, algorithms, and scientific content on our platform!

3 - Switched to Hugo Docsy!

Note: Authors and citation features are currently broken. We are working on a fix.

We are excited to announce that the KintaroAI documentation site has switched to the Hugo Docsy theme!

This change brings:

  • Faster site generation
  • Modern, responsive design
  • Improved navigation and search
  • Easier content management for contributors

Stay tuned for more updates and new features!

4 - Authors Feature Enabled

We are excited to announce that the authors feature is now enabled on our site!

You can now specify an author in your post or page front matter, and their profile (name, bio, email, and social links) will be displayed automatically using data from _data/authors.yaml.

Usage Example

Add the following to your post or page front matter:

---
title: "My Awesome Post"
date: 2025-07-15
authors:
  - baraban
  - llm-kun
---

That’s it! The author’s information will appear at the end of your post.

If you want to add more authors, simply update the _data/authors.yaml file with their details.

Happy documenting!

5 - Added citation support

Usage example: Header like this

---
title:  "Added citation support"
date:   2025-04-19 19:49:00 -0500
authors:
  - Baraban
  - LLM Kun
---

will render:

Baraban, & Kun, L. (2025). Added citation support. http://KintaroAI.com/blog/2025/04/19/added-citation-support/ (KintaroAI)

6 - Changed theme to Docsy Jekyll

Now using Docsy Jekyll theme.

Features:

  • Create documentation issue in linked Github repository.
  • Create project issue.
  • Edit current page.
  • Navigation is automatically built out of headers.
  • Left menu.
  • Search (though it would require update in the future).
  • Nice badges, buttons and other formatting features.

7 - Changed Github repo name back

Returned original repo back.

8 - Changed Github repo name

Previous one was auto suspended so created new one.

Stay tuned.

9 - Coming Soon!

Kintaro

10 - Easy documentation with Docsy

The Docsy Hugo theme lets project maintainers and contributors focus on content, not on reinventing a website infrastructure from scratch

This is a typical blog post that includes images.

The front matter specifies the date of the blog post, its title, a short description that will be displayed on the blog landing page, and its author.

Including images

Here’s an image (featured-sunset-get.png) that includes a byline and a caption.

Fetch and scale an image in the upcoming Hugo 0.43.
Photo: Riona MacNamara / CC-BY-CA

The front matter of this post specifies properties to be assigned to all image resources:

resources:
- src: "**.{png,jpg}"
  title: "Image #:counter"
  params:
    byline: "Photo: Riona MacNamara / CC-BY-CA"

To include the image in a page, specify its details like this:

{{< imgproc sunset Fill "600x300" >}}
Fetch and scale an image in the upcoming Hugo 0.43.
{{< /imgproc >}}

The image will be rendered at the size and byline specified in the front matter.

11 - Second blog post

A short lead description about this content page. Text here can also be bold or italic and can even be split over multiple paragraphs.

Text can be bold, italic, or strikethrough. Links should be blue with no underlines (unless hovered over).

There should be whitespace between paragraphs. There should be whitespace between paragraphs. There should be whitespace between paragraphs. There should be whitespace between paragraphs.

There should be whitespace between paragraphs. There should be whitespace between paragraphs. There should be whitespace between paragraphs. There should be whitespace between paragraphs.

There should be no margin above this first sentence.

Blockquotes should be a lighter gray with a border along the left side in the secondary color.

There should be no margin below this final sentence.

First Header

This is a normal paragraph following a header. Bacon ipsum dolor sit amet t-bone doner shank drumstick, pork belly porchetta chuck sausage brisket ham hock rump pig. Chuck kielbasa leberkas, pork bresaola ham hock filet mignon cow shoulder short ribs biltong. Bacon ipsum dolor sit amet t-bone doner shank drumstick, pork belly porchetta chuck sausage brisket ham hock rump pig. Chuck kielbasa leberkas, pork bresaola ham hock filet mignon cow shoulder short ribs biltong. Bacon ipsum dolor sit amet t-bone doner shank drumstick, pork belly porchetta chuck sausage brisket ham hock rump pig. Chuck kielbasa leberkas, pork bresaola ham hock filet mignon cow shoulder short ribs biltong.

Bacon ipsum dolor sit amet t-bone doner shank drumstick, pork belly porchetta chuck sausage brisket ham hock rump pig. Chuck kielbasa leberkas, pork bresaola ham hock filet mignon cow shoulder short ribs biltong.

On big screens, paragraphs and headings should not take up the full container width, but we want tables, code blocks and similar to take the full width.

Lorem markdownum tuta hospes stabat; idem saxum facit quaterque repetito occumbere, oves novem gestit haerebat frena; qui. Respicit recurvam erat: pignora hinc reppulit nos aut, aptos, ipsa.

Meae optatos passa est Epiros utiliter Talibus niveis, hoc lata, edidit. Dixi ad aestum.

Header 2

This is a blockquote following a header. Bacon ipsum dolor sit amet t-bone doner shank drumstick, pork belly porchetta chuck sausage brisket ham hock rump pig. Chuck kielbasa leberkas, pork bresaola ham hock filet mignon cow shoulder short ribs biltong.

Header 3

This is a code block following a header.

Header 4

  • This is an unordered list following a header.
  • This is an unordered list following a header.
  • This is an unordered list following a header.
Header 5
  1. This is an ordered list following a header.
  2. This is an ordered list following a header.
  3. This is an ordered list following a header.
Header 6
WhatFollows
A tableA header
A tableA header
A tableA header

There’s a horizontal rule above and below this.


Here is an unordered list:

  • Salt-n-Pepa
  • Bel Biv DeVoe
  • Kid ‘N Play

And an ordered list:

  1. Michael Jackson
  2. Michael Bolton
  3. Michael Bublé

And an unordered task list:

  • Create a sample markdown document
  • Add task lists to it
  • Take a vacation

And a “mixed” task list:

  • Steal underpants
  • ?
  • Profit!

And a nested list:

  • Jackson 5
    • Michael
    • Tito
    • Jackie
    • Marlon
    • Jermaine
  • TMNT
    • Leonardo
    • Michelangelo
    • Donatello
    • Raphael

Definition lists can be used with Markdown syntax. Definition terms are bold.

Name
Godzilla
Born
1952
Birthplace
Japan
Color
Green

Tables should have bold headings and alternating shaded rows.

ArtistAlbumYear
Michael JacksonThriller1982
PrincePurple Rain1984
Beastie BoysLicense to Ill1986

If a table is too wide, it should scroll horizontally.

ArtistAlbumYearLabelAwardsSongs
Michael JacksonThriller1982Epic RecordsGrammy Award for Album of the Year, American Music Award for Favorite Pop/Rock Album, American Music Award for Favorite Soul/R&B Album, Brit Award for Best Selling Album, Grammy Award for Best Engineered Album, Non-ClassicalWanna Be Startin’ Somethin’, Baby Be Mine, The Girl Is Mine, Thriller, Beat It, Billie Jean, Human Nature, P.Y.T. (Pretty Young Thing), The Lady in My Life
PrincePurple Rain1984Warner Brothers RecordsGrammy Award for Best Score Soundtrack for Visual Media, American Music Award for Favorite Pop/Rock Album, American Music Award for Favorite Soul/R&B Album, Brit Award for Best Soundtrack/Cast Recording, Grammy Award for Best Rock Performance by a Duo or Group with VocalLet’s Go Crazy, Take Me With U, The Beautiful Ones, Computer Blue, Darling Nikki, When Doves Cry, I Would Die 4 U, Baby I’m a Star, Purple Rain
Beastie BoysLicense to Ill1986Mercury RecordsnoawardsbutthistablecelliswideRhymin & Stealin, The New Style, She’s Crafty, Posse in Effect, Slow Ride, Girls, (You Gotta) Fight for Your Right, No Sleep Till Brooklyn, Paul Revere, Hold It Now, Hit It, Brass Monkey, Slow and Low, Time to Get Ill

Code snippets like var foo = "bar"; can be shown inline.

Also, this should vertically align with this and this.

Code can also be shown in a block element.

foo := "bar";
bar := "foo";

Code can also use syntax highlighting.

func main() {
  input := `var foo = "bar";`

  lexer := lexers.Get("javascript")
  iterator, _ := lexer.Tokenise(nil, input)
  style := styles.Get("github")
  formatter := html.New(html.WithLineNumbers())

  var buff bytes.Buffer
  formatter.Format(&buff, style, iterator)

  fmt.Println(buff.String())
}
Long, single-line code blocks should not wrap. They should horizontally scroll if they are too long. This line should be long enough to demonstrate this.

Inline code inside table cells should still be distinguishable.

LanguageCode
Javascriptvar foo = "bar";
Rubyfoo = "bar"{

Small images should be shown at their actual size.

Cat Neo

Large images should always scale down and fit in the content container.

Cats Millie & Neo

Components

Alerts

Sizing

Add some sections here to see how the ToC looks like. Bacon ipsum dolor sit amet t-bone doner shank drumstick, pork belly porchetta chuck sausage brisket ham hock rump pig. Chuck kielbasa leberkas, pork bresaola ham hock filet mignon cow shoulder short ribs biltong.

Parameters available

Bacon ipsum dolor sit amet t-bone doner shank drumstick, pork belly porchetta chuck sausage brisket ham hock rump pig. Chuck kielbasa leberkas, pork bresaola ham hock filet mignon cow shoulder short ribs biltong.

Using pixels

Bacon ipsum dolor sit amet t-bone doner shank drumstick, pork belly porchetta chuck sausage brisket ham hock rump pig. Chuck kielbasa leberkas, pork bresaola ham hock filet mignon cow shoulder short ribs biltong.

Using rem

Bacon ipsum dolor sit amet t-bone doner shank drumstick, pork belly porchetta chuck sausage brisket ham hock rump pig. Chuck kielbasa leberkas, pork bresaola ham hock filet mignon cow shoulder short ribs biltong.

Memory

Bacon ipsum dolor sit amet t-bone doner shank drumstick, pork belly porchetta chuck sausage brisket ham hock rump pig. Chuck kielbasa leberkas, pork bresaola ham hock filet mignon cow shoulder short ribs biltong.

RAM to use

Bacon ipsum dolor sit amet t-bone doner shank drumstick, pork belly porchetta chuck sausage brisket ham hock rump pig. Chuck kielbasa leberkas, pork bresaola ham hock filet mignon cow shoulder short ribs biltong.

More is better

Bacon ipsum dolor sit amet t-bone doner shank drumstick, pork belly porchetta chuck sausage brisket ham hock rump pig. Chuck kielbasa leberkas, pork bresaola ham hock filet mignon cow shoulder short ribs biltong.

Used RAM

Bacon ipsum dolor sit amet t-bone doner shank drumstick, pork belly porchetta chuck sausage brisket ham hock rump pig. Chuck kielbasa leberkas, pork bresaola ham hock filet mignon cow shoulder short ribs biltong.

This is the final element on the page and there should be no margin below this.