Skip to content

Commit 7048e5b

Browse files
committed
editing/code: add warning about highlight+linenos
1 parent bbd0972 commit 7048e5b

File tree

1 file changed

+6
-0
lines changed

1 file changed

+6
-0
lines changed

_pages/editing/code.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -85,6 +85,12 @@ Right now, inline code snippets cannot have line numbers; see
8585
for technical details. For now, if you want to have line numbers, use the
8686
[Embedding external code](#embedding-external-code) approach below.
8787

88+
{% include notice icon='warning' content="
89+
You might be familiar with the `linenos` argument to the `highlight` directive.
90+
Please ___do not use this___. As of this writing (Q3 2021), it produces badly
91+
formed HTML output, which can break wiki pages.
92+
" %}
93+
8894
## Making code snippets executable and editable
8995

9096
By enabling the `imjoy` extension, you can make your code snippets executable and editable.

0 commit comments

Comments
 (0)