From f681e3fe8450888e3048ce914a032f1b87416e06 Mon Sep 17 00:00:00 2001 From: Oliver Steele Date: Sun, 27 Aug 2017 14:33:58 -0400 Subject: [PATCH] Doc another autogenerated header id incompat --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index 8e2dccd..48a7684 100644 --- a/README.md +++ b/README.md @@ -116,9 +116,13 @@ By design: - `serve --watch` (the default) reloads the `_config.yml` and data files too. - `serve` generates pages on the fly; it doesn't write to the file system. - Files are cached in `/tmp/gojekyll-${USER}`, not `./.sass-cache` + +Upstream: + - Markdown: - `<` and `>` inside markdown is interpreted as HTML. For example, `This is bold` renders as bold. This behavior matches the [Markdown spec](https://daringfireball.net/projects/markdown/syntax#html), but differs from Jekyll's default Kramdown processor. - The autogenerated id of a header that includes HTML is computed from the text of the title, ignoring its attributes. For example, the id of `## Title (ref))` is `#title-ref`, not `#title-https-example-path-to-details-ref`. + - Autogenerated header ids replace punctuation by the hyphens, rather than the empty string. For example, the id of `## Either/or` is `#either-or` not `#eitheror`; the id of `## I'm Lucky` is `#i-m-lucky` not `#im-lucky`. Muzukashii: