0.12.10 - 2020-09-21¶
- 🐛 FIX: allow dates to be parsed in frontmatter.
This fixes a bug that would raise errors at parse time if non-string date objects were in front-matter YAML. See #253
0.12.9 - 2020-09-08¶
- ✨ NEW: Auto-generate heading anchors.
anchors-plugin, to generate unique anchor “slugs” for each header (up to a certain level), and allows them to be referenced via a relative path, e.g.
(./file.md#header-anchor), or in the same document, e.g.
Slugs are generated in the GitHub style (see here); lower-case text, removing punctuation, replacing spaces with
-, enforce uniqueness via suffix enumeration
It is enabled in your
myst_heading_anchors = 2(sets maximum heading level).
- 🐛 FIX: doc reference resolution for singlehtml/latex.
These reference resolutions are passed to the “missing-reference” event, and require the
node["refdoc"]attribute to be available, which was missing for
0.12.7 - 2020-08-31¶
- ✨ NEW: Want to include your README.md in the documentation?
relative-docs option in 0.12.8)
0.12.5 - 2020-08-28¶
- ✨ NEW: Add Markdown figure syntax
myst_figure_enable = Truein your sphinx
conf.py, combines the above two extended syntaxes, to create a fully Markdown compliant version of the
figuredirective. See Markdown Figures for details.
(👌 formatting of caption improved in 0.12.6)
0.12.4 - 2020-08-27¶
👌 IMPROVE: the mathjax extension is now only overridden if strictly necessary (to support dollar and ams math), and the override is more precise, to mitigate any unwanted side-effects
0.12.3 - 2020-08-26¶
- ✨ NEW: Add definition lists.
This addition, enabled by
myst_deflist_enable = True, allows for “Pandoc style” definition lists to be parsed and rendered, e.g.
Term 1 : Definition
See the Definition Lists documentation for further details.
- 👌 IMPROVE: mathjax_config override.
mathjax_config["tex2jax"]will now be overridden, in order to not interfere with other user configurations, such as adding TeX macros. The configuration name has also changed from
myst_update_mathjax. See Mathjax and math parsing for further details.
0.12.2 - 2020-08-25¶
- ✨ NEW: Add the
This directive parses its contents as ReStructuredText, which integrates back into the rest of the document, e.g. for cross-referencing. See this documentation for further explanation.
In particular, this addition solves some outstanding user requests:
Thanks to @stephenroller for the contribution 🎉
0.12.1 - 2020-08-19¶
✨ NEW: Add
myst_commonmark_only config option, for restricting the parser to strict CommonMark (no extensions).
0.12.0 - 2020-08-19¶
If you are using math in your documents, be sure to read the updated Math syntax guide!
In particular, the Mathjax configuration is now overridden, such that LaTeX environments will only be rendered if
myst_amsmath_enable=True is set.
myst_math_delimiters option has also been removed (please open an issue if you would like brackets math parsing to be re-implemented).
In addition the
myst_html_img option name has been changed to
Some underlying code has also been refactored, to centralise handling of configuration options (see commit 98573b9).
0.11.2 - 2020-07-13¶
<img src="file.png" width="200px">tag parsing to sphinx representation, see the image syntax guide
0.11.0 - 2020-07-12¶
0.10.0 - 2020-07-08¶
@akhmerov | @asmeurer | @certik | @choldgraf | @chrisjsewell | @codecov | @dhermes | @filippo82 | @jlperla | @jstac | @martinagvilas | @mlncn | @mmcky | @moorepants | @najuzilu | @nathancarter | @pauleveritt | @phaustin | @rossbar | @rowanc1 | @sbliven | @webknjaz