Related: Markdown Tips and Tricks
https://ghost.org/blog/markdown/
https://github.com/DavidWells/advanced-markdown
collapse
Sections
Collapsing large blocks of text can make your markdown much easier to digest
"Click to expand"
<details>
<summary>"Click to expand"</summary>
this is hidden
</details>
https://github.com/Naereen/badges
https://forthebadge.com/
One neat trick which you can use in Markdown to distinguish between different types of images is to add a value to the end of the source URL, and then target images containing the hash with special styling.
which is styled with...
This creates full-bleed images in the Casper theme, which stretch beyond their usual boundaries right up to the edge of the window. Every theme handles these types of things slightly differently, but it's a great trick to play with if you want to have a variety of image sizes and styles.
Reference lists
Another way to insert links in markdown is using reference lists. You might want to use this style of linking to cite reference material in a Wikipedia-style. All of the links are listed at the end of the document, so you can maintain full separation between content and its source or reference.
Code folding
Please use code folding, with the default set to
hide
.Data frame printing
If you have to display a large data table, it would be nice to allow your readers the chance to page and scroll through it. Use the Paged Printing option by setting
df_print: paged
in YAML.---
title: "My document"
output:
html_document:
df_print: paged
---
https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet#links
[I'm an inline-style link](https://www.google.com)
[I'm an inline-style link with title](https://www.google.com "Google's Homepage")
[I'm a reference-style link][Arbitrary case-insensitive reference text]
[I'm a relative reference to a repository file](../blob/master/LICENSE)
[You can use numbers for reference-style link definitions][1]
Or leave it empty and use the [link text itself].
URLs and URLs in angle brackets will automatically get turned into links.
http://www.example.com or <http://www.example.com> and sometimes
example.com (but not on Github, for example).
Some text to show that the reference links can follow later.
[arbitrary case-insensitive reference text]: https://www.mozilla.org
[1]: http://slashdot.org
[link text itself]: http://www.reddit.com
Page breaks
Sometimes your document doesn’t flow exactly how you want it when printing or exporting to PDF. You can force a page break in iA Writer using three plus marks (+) on a line by themselves:
+++
https://docs.microsoft.com/en-us/contribute/how-to-write-use-markdown
https://michelf.ca/projects/php-markdown/extra/#table
Alt text
Alt text that contains underscores won't be rendered properly. For example, instead of using this:
markdown

Escape the underscores like this:
markdown

https://michelf.ca/projects/php-markdown/extra/#table