Unclaimed project
Are you a maintainer of quarkdown? Claim this project to take control of your public changelog and roadmap.
Changelog
πͺ Markdown with superpowers: from ideas to papers, presentations, websites, books, and knowledge bases.
Used in combination with page margin content, the new .lastheading function allows for persistent headings, such as chapter titles or section names, to be displayed in the page margins of paged and slides documents.
.pagemargin {topcenter}
*.lastheading depth:{1}*
# Chapter 1
.repeat {10}
.loremipsum
Β
The .pagemargin function now accepts new positions:
topoutsidecorner, topoutside, topinsidecorner, topinside, bottomoutsidecorner, bottomoutside, bottominsidecorner, bottominside.
Contrary to fixed positions such as topright or bottomleft, these mirror positions adapt based on whether the page is left or right, great for printing.
.pagemargin {topoutside}
**This** is a margin content.
The function also no longer has topcenter as the default position.
Β
Specific elements can be assigned custom CSS class names by means of the classname parameter, available in .container (for blocks) and .text (for inlines).
.container classname:{my-custom-class}
This is a block with a custom class.
---
This is an .text {inline text} classname:{my-custom-class} with a custom class.
.css
.my-custom-class {
padding: 8px;
background: linear-gradient(to right, pink 0%, lightblue 100%);
}
[!TIP] You can return custom elements from user-defined functions for enhanced reusability and readability!
Β
.font calls can now be stacked to create multiple font configurations, which are applied in order. Each configuration acts as a fallback for the next one, in case the current font does not contain glyphs for certain characters.
This is particularly useful for multi-language documents. For example, you may set a primary font for Latin characters and a fallback font for CJK characters:
.font {GoogleFonts:Ma Shan Zheng}
.font {GoogleFonts:Corinthia}
Β
Emojis can now be inserted using shortcodes via the .emoji function.
| Type | Result | Code |
|---|:---:|---|
| Simple shortcode | π | .emoji {wink} |
| One skin tone | ππΎ | .emoji {waving-hand~medium-dark} |
| Two skin tones | π§πΌβπ€βπ§πΎ | .emoji {people-holding-hands~medium-light,medium-dark} |
For a complete list of supported shortcodes, refer to the Emoji Cheat Sheet.
Fun fact: the cheat sheet was generated with Quarkdown + Hugo!
Β
The new .tablebyrows function allows for dynamic table generation by rows.
.var {headers}
- Name
- Age
- City
.tablebyrows {.headers}
- - John
- 25
- NY
- - Lisa
- 32
- LA
- - Mike
- 19
- CHI
| Name | Age | City | |------|-----|------| | John | 25 | NY | | Lisa | 32 | LA | | Mike | 19 | CHI |
Β
.codespan {text} can now be used to create inline code spans, similar to backticks (`text`).
Just like .code as an alternative to triple-backtick code blocks, the difference is that .codespan supports function calls, allowing
for dynamic content, whereas backticks do not.
Β
The web frontend underwent a complete rewrite, with performance and maintainability in mind.
The number of synchronous tasks has been reduced, making initial page load faster, with impact on PDF generation time as well.
classname parameter to .container by @iamgio in https://github.com/iamgio/quarkdown/pull/227classname parameter to .text by @iamgio in https://github.com/iamgio/quarkdown/pull/228Full Changelog: https://github.com/iamgio/quarkdown/compare/v1.10.0...v1.11.0
Shout out to our new sponsor: @RayOffiah π
