only one header per doc file

doc/2-interface/asset-list.md

@@ -1,4 +1,8 @@
-# instrument list
+# asset list
+
+an "asset" refers to an instrument, wavetable or sample.
+
+## instrument list
 
 ![instruments window](instruments.png)
 
@@ -29,7 +33,7 @@ assets may be dragged from folder to folder and even rearranged within folders w
 
 right-clicking on a folder allows one to rename or delete it. deleting a folder does not remove the instruments in it.
 
-# wavetable list
+## wavetable list
 
 ![wavetables window](wavetables.png)
 
@@ -41,7 +45,7 @@ wavetables are saved as Furnace wavetable (.fuw) files.
   - **save wavetable as .dmw...**: saves the selected wavetable in DefleMask format.
   - **save raw wavetable...**: saves the selected wavetable as raw data.
 
-# sample list
+## sample list
 
 ![samples window](samples.png)
 

doc/2-interface/menu-bar.md

@@ -4,7 +4,7 @@ the menu bar allows you to select from five menus: file, edit, settings, window
 
 items in _italic_ don't appear in basic mode and are only available in advanced mode.
 
-# file
+## file
 
 - **new...**: creates a new song.
 - **open...**: opens the file picker, allowing you to select a song to open.
@@ -52,7 +52,7 @@ items in _italic_ don't appear in basic mode and are only available in advanced
 
 - **exit**: closes Furnace.
 
-## export audio
+### export audio
 
 this option allows you to export your song in .wav format. I know I know, no .mp3 or .ogg export yet, but you can use a converter.
 
@@ -70,7 +70,7 @@ and three export choices:
 - **multiple files (one per channel)**: exports the output of each channel to .wav files.
   - useful for usage with a channel visualizer such as corrscope.
 
-## export VGM
+### export VGM
 
 this option allows exporting to a VGM (Video Game Music) file. these can be played back with VGMPlay (for example).
 
@@ -104,7 +104,7 @@ the following settings exist:
 
 click on **click to export** to begin exporting.
 
-## export ZSM
+### export ZSM
 
 ZSM (ZSound Music) is a format designed for the Commander X16 to allow hardware playback.
 it may contain data for either YM2151 or VERA chips.
@@ -120,7 +120,7 @@ the following settings are available:
 
 click on **Begin Export** to... you know.
 
-## export command stream
+### export command stream
 
 this option exports a text or binary file which contains a dump of the internal command stream produced when playing the song.
 
@@ -129,7 +129,7 @@ it's not really useful, unless you're a developer and want to use a command stre
 - **export (binary)**: exports in Furnace's own command stream format (FCS). see `export-tech.md` in `papers/` for details.
 - **export (text)**: exports the command stream as a text file. only useful for analysis, really.
 
-# edit
+## edit
 
 - **...**: does nothing except prevent accidental clicks on later menu items if the menu is too tall to fit on the program window.
 
@@ -191,7 +191,7 @@ it's not really useful, unless you're a developer and want to use a command stre
 
 - **clear**: opens a window that allows you to mass-delete things like songs, unused instruments, and the like.
 
-# settings
+## settings
 
 - **full screen**: expands the Furnace window so it covers your screen.
 - **lock layout**: prevents you from dragging/resizing docked windows, or docking more.
@@ -200,7 +200,7 @@ it's not really useful, unless you're a developer and want to use a command stre
 - **reset layout**: resets the workspace to its defaults.
 - **settings...**: shows the Settings window. these are detailed in [settings.md].
 
-# window
+## window
 
 all these menu items show or hide their associated windows.
 
@@ -228,7 +228,7 @@ all these menu items show or hide their associated windows.
 - [log viewer](../8-advanced/log-viewer.md)
 - [stats](../8-advanced/stats.md)
 
-# help
+## help
 
 - **effect list**: displays the effect list.
 - **debug menu**: this menu contains various debug utilities.

doc/2-interface/song-info.md

@@ -9,7 +9,7 @@ all of this metadata will be included in a VGM export. this isn't the case for a
 
 - _**Tuning (A-4)**_: set tuning based on the note A-4, which should be 440 in most cases. opening an Amiga MOD will set it to 436 for hardware compatibility. available only in advanced mode.
 
-# subsongs
+## subsongs
 
 this window allows one to create **subsongs** - multiple individual songs within a single file. each song has its own order list and patterns, but all songs within a file share the same chips, samples, and so forth.
 
@@ -19,7 +19,7 @@ this window allows one to create **subsongs** - multiple individual songs within
 - **Name**: title of the current subsong.
 - the box at the bottom can store any arbitrary text, like a separate "Comments" box for the current subsong.
 
-# speed
+## speed
 
 there are multiple ways to set the tempo of a song.