Markdown 语法指南

2022-10-20T00:00:00+00:00

本文提供了一个基本的 Markdown 语法示例，这些语法可以在 Zola 内容文件中使用。同时，本文也展示了基本的 HTML 元素在林基塔主题中是否会使用 CSS 进行装饰。

数学排版

2022-10-20T00:00:00+00:00

Linkita 主题支持使用 KaTeX</a> 排版 $\LaTeX$ 数学公式。

简码

2022-10-20T00:00:00+00:00

林基塔主题提供了多种简码。

没听说过简码？请参阅 Zola 文档</a> 获取更多信息。

Mermaid</h2>

要在页面中使用 Mermaid，您需要在页面的 frontmatter 中设置 extra.mermaid = true</code>。

+++</span></span>
title</span> =</span> "</span>您的页面标题</span>"</span></span>
</span>
[</span>extra</span>]</span></span>
mermaid</span> =</span> true</span></span>
+++</span></span></code></pre>
然后您可以使用 mermaid()</code> 简码，例如：</p>
{% mermaid() %}</span></span>
</span>
graph TD;</span></span>
A-->B;</span></span>
A-->C;</span></span>
B-->D;</span></span>
C-->D;</span></span>
</span>
{% end %}</span></span></code></pre>
这将被渲染为：</p>
  graph TD;
A-->B;
A-->C;
B-->D;
C-->D;
</pre>
此外，您可以在 mermaid()</code> 简码内使用代码块，代码块将被忽略。</p>
代码块可以防止格式化程序破坏 mermaid 的格式。</p>
{% mermaid() %}</span></span>
</span>
```</span>mermaid</span></span>
sequenceDiagram</span></span>
    participant Alice</span></span>
    participant Bob</span></span>
    Alice->>John: Hello John, how are you?</span></span>
    loop Healthcheck</span></span>
        John->>John: Fight against hypochondria</span></span>
    end</span></span>
    Note right of John: Rational thoughts <br/>prevail!</span></span>
    John-->>Alice: Great!</span></span>
    John->>Bob: How about you?</span></span>
    Bob-->>John: Jolly good!</span></span>
```</span></span>
</span>
{% end %}</span></span></code></pre>
这将被渲染为：</p>
  
sequenceDiagram
    participant Alice
    participant Bob
    Alice->>John: Hello John, how are you?
    loop Healthcheck
        John->>John: Fight against hypochondria
    end
    Note right of John: Rational thoughts <br/>prevail!
    John-->>Alice: Great!
    John->>Bob: How about you?
    Bob-->>John: Jolly good!

</pre>
提示框</h2>
admonition()</code> 简码显示一个横幅，帮助您在页面中放置提示。</p>
您可以像这样使用 admonition()</code> 简码：</p>
{% admonition(type="tip", title="tip") %}</span></span>
`</span>tip</span>`</span> 提示框。</span></span>
{% end %}</span></span></code></pre>
提示框简码有 12 种不同的类型：</p>




  
    
      note
    </div>
    note</strong></span>
  </div>
  note</code> 提示框。</p>
</div>
</div>



  
    
      abstract
    </div>
    abstract</strong></span>
  </div>
  abstract</code> 提示框。</p>
</div>
</div>



  
    
      info
    </div>
    info</strong></span>
  </div>
  info</code> 提示框。</p>
</div>
</div>



  
    
      tip
    </div>
    tip</strong></span>
  </div>
  tip</code> 提示框。</p>
</div>
</div>



  
    
      success
    </div>
    success</strong></span>
  </div>
  success</code> 提示框。</p>
</div>
</div>



  
    
      question
    </div>
    question</strong></span>
  </div>
  question</code> 提示框。</p>
</div>
</div>



  
    
      warning
    </div>
    warning</strong></span>
  </div>
  warning</code> 提示框。</p>
</div>
</div>



  
    
      failure
    </div>
    failure</strong></span>
  </div>
  failure</code> 提示框。</p>
</div>
</div>



  
    
      danger
    </div>
    danger</strong></span>
  </div>
  danger</code> 提示框。</p>
</div>
</div>



  
    
      bug
    </div>
    bug</strong></span>
  </div>
  bug</code> 提示框。</p>
</div>
</div>



  
    
      example
    </div>
    example</strong></span>
  </div>
  example</code> 提示框。</p>
</div>
</div>



  
    
      quote
    </div>
    quote</strong></span>
  </div>
  quote</code> 提示框。</p>
</div>
</div>
画廊</h2>
gallery()</code> 简码是一个非常简单的纯 HTML 可点击图片画廊，用于显示页面资源中的所有图像。</p>
它来自 Zola 文档</a></p>
{{ gallery() }}</span></span></code></pre>

  
    
  </a>
  
    
  </a>
  
    
  </a>
  
    
  </a>
  
    
  </a>
  
    
  </a>
  
    
  </a>
  
    
  </a>
</div>
项目</h2>
projects()</code> 短代码允许您为您的项目创建一个页面。</p>
创建一个 content/pages/projects/index.md</code> 文件：</p>
+++</span></span>
title = "我的项目"</span></span>
description = ""</span></span>
path = "projects"</span></span>
+++</span></span>
</span>
{{ projects(path="data.toml", format="toml") }}</span></span></code></pre>
创建一个 content/pages/projects/data.toml</code> 文件：</p>
[[</span>project</span>]]</span></span>
name</span> =</span> "</span>lorem</span>"</span></span>
desc</span> =</span> "</span>Lorem ipsum dolor sit.</span>"</span></span>
tags</span> =</span> [</span>"</span>lorem</span>"</span>,</span> "</span>ipsum</span>"</span>]</span></span>
links</span> =</span> [</span></span>
    {</span> name</span> =</span> "</span>homepage</span>"</span>,</span> url</span> =</span> "</span>https://example.com</span>"</span> }</span>,</span></span>
    {</span> name</span> =</span> "</span>source</span>"</span>,</span> url</span> =</span> "</span>https://example.com</span>"</span> }</span>,</span></span>
]</span></span></code></pre>
这将显示为：</p>


  lorem</h2>
  Lorem ipsum dolor sit.</p>
  
    
      #lorem</span>
      #ipsum</span>
    </div>
    
      homepage</a>
      source</a>
    </div>
  </div>
</div>

林基塔

Markdown 语法指南

数学排版

简码

提示框</h2> admonition()</code> 简码显示一个横幅，帮助您在页面中放置提示。</p> 您可以像这样使用 admonition()</code> 简码：</p>

项目</h2> projects()</code> 短代码允许您为您的项目创建一个页面。</p> 创建一个 content/pages/projects/index.md</code> 文件：</p>

lorem</h2> Lorem ipsum dolor sit.</p>

lorem</h2>
Lorem ipsum dolor sit.</p>

#lorem</span> #ipsum</span> </div>
homepage</a> source</a> </div> </div> </div>