Tools
Guide
https://squidfunk.github.io/mkdocs-material/reference/
Math
Coding
| Heap Sort | |
|---|---|
if __name__ == "__main__":
just_fix_windows_console() #itβs safe to call this function on non-Windows platforms
CoreLogic()
Content Tabs
Etiam eleifend dictum erat. Etiam vel felis vitae turpis aliquet feugiat. Proin vel ex arcu. Sed quis nulla interdum, mollis lorem vitae, euismod tortor. Sed a odio ligula. Curabitur finibus pellentesque purus, vel feugiat dui. Suspendisse potenti.
- No time to lose.
- I'm trying to figure out a way to get rid of you so I can go commit atrocities. ...Wait, did you think I was being serious?
- Da-da-da~
- Lalala~
Admonitions
Collassabile
Lorem ipsum
Outer Note
dolor
Inner Note
sit amet
Inline examples
Inline
Inline End
No title
All types
Note
Abstract
Info
Tip
Success
Question
Warning
Failure
Danger
Bug
Example
Quote
Annotations
A golden chest on the horizon, everyone amazed. (1)
- This look shiny!
Exampleeee! (1)
Is time to gamble! (2) Again!
I'm an annotation!
I'm an annotation as well!
A golden chest on the horizon, everyone amazed. (1)
- This look like not a coding language!
Buttons
Data tables
| Method | Description |
|---|---|
GET | Fetch resource |
PUT | Update resource |
DELETE | Delete resource |
Diagrams
Flowcharts
graph LR
A[Start] --> B{Error?};
B -->|Yes| C[Hmm...];
C --> D[Debug];
D --> B;
B ---->|No| E[Yay!]; Sequence Diagrams
sequenceDiagram
autonumber
Alice->>John: Hello John, how are you?
loop Healthcheck
John->>John: Fight against hypochondria
end
Note right of John: Rational thoughts!
John-->>Alice: Great!
John->>Bob: How about you?
Bob-->>John: Jolly good! State Diagrams
stateDiagram-v2
state fork_state <<fork>>
[*] --> fork_state
fork_state --> State2
fork_state --> State3
state join_state <<join>>
State2 --> join_state
State3 --> join_state
join_state --> State4
State4 --> [*] Class Diagrams
classDiagram
Person <|-- Student
Person <|-- Professor
Person : +String name
Person : +String phoneNumber
Person : +String emailAddress
Person: +purchaseParkingPass()
Address "1" <-- "0..1" Person:lives at
class Student{
+int studentNumber
+int averageMark
+isEligibleToEnrol()
+getSeminarsTaken()
}
class Professor{
+int salary
}
class Address{
+String street
+String city
+String state
+int postalCode
+String country
-validate()
+outputAsLabel()
} Entity-Relationship Diagrams
erDiagram
CUSTOMER ||--o{ ORDER : places
ORDER ||--|{ LINE-ITEM : contains
LINE-ITEM {
string name
int pricePerUnit
}
CUSTOMER }|..|{ DELIVERY-ADDRESS : uses Extras
Pie charts, Gantt Charts, User Journeys, Git Graphs and Requirement Diagrams
ELK layouts
Footnotes
Sponsors only
Formatting
Text can be deleted and replacement text added. This can also be combined into onea single operation. Highlighting is also possible and comments can be added inline.
Formatting can also be applied to blocks by putting the opening and closing tags on separate lines and adding new lines between the tags and the content.
Highlighting text
- This was marked (highlight)
- This was inserted (underline)
This was deleted (strikethrough)
Sub- and superscripts
- H2O
- ATA
keyboard keys
Ctrl+Alt+Del
Grids
Card Grids
- HTML for content and structure
- JavaScript for interactivity
- CSS for text running out of boxes
- Internet Explorer ... huh?
Card grid, complex example (Hide the bars)
-
Set up in 5 minutes
Install
mkdocs-materialwithpipand get up and running in minutes -
It's just Markdown
Focus on your content and generate a responsive and searchable static site
-
Made to measure
Change the colors, fonts, language, icons, logo and more with a few lines
-
Open Source, MIT
Material for MkDocs is licensed under MIT and available on [GitHub]
Block syntax
HTML for content and structure
JavaScript for interactivity
CSS for text running out of boxes
Internet Explorer ... huh?
Generic Grids
- Sed sagittis eleifend rutrum
- Donec vitae suscipit est
- Nulla tempor lobortis orci
- Sed sagittis eleifend rutrum
- Donec vitae suscipit est
- Nulla tempor lobortis orci
Icons, Emojis
Colors
Animations
Images
- Lazy loading
- Alignment
- Captions
- Light and dark mode
Lists
- Unordered lists can be written by prefixing a line with a
-,*or+list marker, all of which can be used interchangeably. - Ordered lists must start with a number immediately followed by a dot. The numbers do not need to be consecutive and can be all set to
1. -
When Definition Lists is enabled, lists of arbitrary key-value pairs
Lorem ipsum dolor sit amet-
Sed sagittis eleifend rutrum. Donec vitae suscipit est. Nullam tempus tellus non sem sollicitudin, quis rutrum leo facilisis.
-
When Tasklist is enabled, unordered list items can be prefixed with [ ] to render an unchecked checkbox or [x] to render a checked checkbox
-
Lorem ipsum dolor sit amet, consectetur adipiscing elit
- Vestibulum convallis sit amet nisi a tincidunt
- In hac habitasse platea dictumst
- In scelerisque nibh non dolor mollis congue sed et metus
- Praesent sed risus massa
- Aenean pretium efficitur erat, donec pharetra, ligula non scelerisque
Tooltips
[Hover me](https://github.com/ "I'm a tooltip!") # idk https://example.com
[Hover me][example]
[example]: https://github.com/ "I'm a tooltip!" # idk https://example.com