使用Pandoc从HTML转换为Markdown时如何保留标识符

Question

I can't find the right parameter for this.

In my HTML-document I have a line like this:

<h2 id="seminar-teil-1">Seminar Teil 1</h2>

Now I want to convert this .html-document to a Markdown-Document. The end result should be:

## Seminar Teil 1   {#seminar-teil-1}

How do I get this done?

Answer 1

Ah! No wonder you were struggling. By default, identifiers are in fact preserved.

> pandoc -f html -t markdown
<h1 id="uid">Seminar 1</h1>

Output

Seminar 1 {#uid}
=========

There is one special case though, when your identified matches the identifier which pandoc automatically generates then no identifier is emitted. The automatic identifier is basically a lower case alphanumeric version of the title interspersed with dashs (exactly like your custom identifier!).

To turn this feature off run pandoc as follows

> pandoc -f html -t markdown-auto_identifiers
<h2 id="seminar-teil-1">Seminar Teil 1</h2>
Seminar Teil 1 {#seminar-teil-1}