Skip to content

Building your website

如何搭建你的网站

推荐一下CCnoccc搭建网站的writeup:CCnocc's writeup

关于material主题的配置问题，可以参考Setup

记录python-markdown拓展使用

参考文献python-markdown语法,一些整合总结一些较为好用的格式。

Python-Markdown拓展库
Extension               “Name”
Extra                   markdown.extensions.extra
    Abbreviations       markdown.extensions.abbr
    Attribute Lists     markdown.extensions.attr_list
    Definition Lists    markdown.extensions.def_list
    Fenced Code Blocks  markdown.extensions.fenced_code
    Footnotes           markdown.extensions.footnotes
    Tables              markdown.extensions.tables
    Smart Strong        markdown.extensions.smart_strong
Admonition              markdown.extensions.admonition
CodeHilite              markdown.extensions.codehilite
HeaderId                markdown.extensions.headerid
Meta-Data               markdown.extensions.meta
New Line to Break       markdown.extensions.nl2br
Sane Lists              markdown.extensions.sane_lists
SmartyPants             markdown.extensions.smarty
Table of Contents       markdown.extensions.toc
WikiLinks               markdown.extensions.wikilinks

Extra

abbreviation缩写功能

格式
==============
*[]:----------

def_list定义列表

格式
===
: --------

===
: --------

footnotes脚注

如果你需要一个脚注1

格式
如果你需要一个脚注[^xxxx]
[^xxxx]: 这是你需要的脚注

Admonition 警告

格式
!!! type "name"
    content

Note

content

Abstract

content

Info

content

Tip

content

Success

content

Question

content

Quote

content

Example

content

Warning

content

Danger

content

Failure

content

Bug

content

Details 折叠页

格式
??? type "name"
    content
Note

content

Tabbed 标签

格式（内部可以镶嵌代码块、列表等）
=== "name1"
    content1

=== "name2"
    content2

效果如下：

content1

content2

如果需要同时创建多个Tab，需要在第二个Tab的第一个===后面加上！

Task List 任务列表

格式
Task List

-   [X] item 1
    *   [X] item A
    *   [ ] item B
        more text
        +   [x] item a
        +   [ ] item b
        +   [x] item c
    *   [X] item C
-   [ ] item 2
-   [ ] item 3
Task List

  • item 1
    • item A
    • item B more text
      • item a
      • item b
      • item c
    • item C
  • item 2
  • item 3

Markdown好用格式

块

>呈现一个块

支持嵌套

Tab呈现块
    也支持多级

列表

有序无序列表混搭

  1. Ordered item 1
  2. Ordered item 2
  • Unordered item 1
  • Unordered item 2

希腊字母表

希腊字母表

  1. 这是你需要的脚注 ↩